IDataStore.GetItemString(int row, short column, DwBuffer bufferType = DwBuffer.Primary, bool isOriginalValue = false) Method

.NET Standard 2.x

Gets data whose type is String for the specified row and column from the specified buffer of the DataStore. You can obtain the data that was originally retrieved and stored in the database, as well as the current value in the primary, delete, or filter buffers.

Namespace: DWNet.Data

Assembly: DWNet.Data.dll

Syntax

  public string GetItemString(int row, short column, DwBuffer bufferType = DwBuffer.Primary, bool isOriginalValue = false);

Parameters

row System.Int32

The zero-based row number to get data.

column System.Int16

The zero-based column number to get data.

bufferType DWNet.Data.DwBuffer

The specified buffer of the DataStore. The default is DwBuffer.Primary.

isOriginalValue System.Boolean

Whether to obtain the data that was originally retrieved.

True: to obtain the data that was originally retrieved; False (default): to obtain the current data.

Returns

System.String

Returns the string value in the specified row and column.

Remarks

Use GetItemString to get information from the DataWindow buffer. To access a row in the original buffer, specify the buffer that the row currently occupies (primary, delete, or filter) and the number of the row in that buffer. When you specify true for isOriginalValue, the method gets the original data for that row.

Examples

The following code example demonstrates how to use the GetItemString method to get the string-type value in the specified row and column.

using DWNet.Data;
using System;

namespace Appeon.ApiDoc.IDataStoreExamples
{
    public class GetItemStringExample
    {
        private readonly SchoolContext _context;

        public GetItemStringExample(SchoolContext dataContext)
        {
            // Sets the data context
            _context = dataContext;
        }

        public void Example1()
        {
            // Instantiates a DataStore object with datawindow: d_department.
            var datastore = new DataStore("d_department", _context);

            datastore.Retrieve();
			
			// Sets the "name" column in the first row to "Department Name".
            datastore.SetItem(0, "name", "Department Name");

            // Gets the original value in the first row and in the first and second columns of DataStore.
            // Column 2 (Column name is 'Name') is string type.  
            Console.WriteLine(
                "Original value: Department ID: {0}; Department Name: {1}",
                datastore.GetItem(0, 0),
                datastore.GetItemString(0, 1, DwBuffer.Primary, true));

            // Gets the modified value in the first row and in the first and second columns of DataStore.
            Console.WriteLine(
                "Modified value: Department ID: {0}; Department Name: {1}",
                datastore.GetItem(0, 0),
                datastore.GetItemString(0, 1, DwBuffer.Primary, false));

            /*This code produces the following output:
             
            Original value: Department ID: 1; Department Name: Engineering
            Modified value: Department ID: 1; Department Name: Department Name
            */
        }
    }
}

Example Refer To

Model Class: D_Department
DataWindow File: d_department

Applies to

.NET Standard

2.x