PipelineBuffer.Item Property

Gets the data stored in a buffer column.

Namespace:  Microsoft.SqlServer.Dts.Pipeline
Assembly:  Microsoft.SqlServer.PipelineHost (in Microsoft.SqlServer.PipelineHost.dll)

Syntax

'Declaration
Public Default Property Item ( _
    columnIndex As Integer _
) As Object
    Get
    Set
'Usage
Dim instance As PipelineBuffer
Dim columnIndex As Integer
Dim value As Object

value = instance(columnIndex)

instance(columnIndex) = value
public Object this[
    int columnIndex
] { get; set; }
public:
property Object^ default[int columnIndex] {
    Object^ get (int columnIndex);
    void set (int columnIndex, Object^ value);
}
member Item : Object with get, set
JScript supports the use of indexed properties, but not the declaration of new ones.

Parameters

  • columnIndex
    Type: System.Int32
    The index of the column in the buffer row.

Property Value

Type: System.Object
The data stored in the buffer column as an object.

Remarks

The value stored in a buffer column can be accessed by using one of the data type accessor methods, such as the GetString method, or it can be accessed directly by using array access notation. Accessing a column in the PipelineBuffer by using the Item method is slower than using a data type accessor method because the PipelineBuffer detects the data type stored in the column and then calls the data type accessor method.

Buffer columns containing binary large objects (BLOB) data cannot be retrieved using the array access notation because the amount of data stored in the BLOB column may exceed the available memory. Instead, the GetBlobData method should be used.