PipelineBuffer.Item Property

Artikkeli
12/03/2008

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

public Object this [
    int columnIndex
] { get; set; }

public:
property Object^ default [int] {
    Object^ get (int columnIndex);
    void set (int columnIndex, Object^ value);
}

/** @property */
public Object get_Item (int columnIndex)

/** @property */
public void set_Item (int columnIndex, Object value)

Parameters

columnIndex
The index of the column in the buffer row.

Property Value

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 and GetBytes methods should be used.

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms