DataReader.GetBytes Method (Int32, [], Int32, Int32)

Retrieves a specified number of bytes of raw binary data.

Namespace: Microsoft.VisualStudio.Data.Framework
Assembly: Microsoft.VisualStudio.Data.Framework (in Microsoft.VisualStudio.Data.Framework.dll)

Syntax

'宣言
Public MustOverride Function GetBytes ( _
    index As Integer, _
    buffer As Byte(), _
    bufferIndex As Integer, _
    length As Integer _
) As Integer
'使用
Dim instance As DataReader
Dim index As Integer
Dim buffer As Byte()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Integer

returnValue = instance.GetBytes(index, _
    buffer, bufferIndex, length)

public abstract int GetBytes(
    int index,
    byte[] buffer,
    int bufferIndex,
    int length
)

public:
virtual int GetBytes(
    int index, 
    array<unsigned char>^ buffer, 
    int bufferIndex, 
    int length
) abstract

public abstract function GetBytes(
    index : int, 
    buffer : byte[], 
    bufferIndex : int, 
    length : int
) : int

Parameters

index
Type: System.Int32

Index in the current block of data for the item to retrieve.

buffer
Type: []

An array into which specified data, as a byte array, should be placed. If a null reference (Nothing in Visual Basic), this method returns the size required of the array in order to fit all of the specified data.

bufferIndex
Type: System.Int32

The index of the starting point in the byte array specified in the buffer parameter.

length
Type: System.Int32

The number of bytes to be read into the byte array specified in the buffer parameter.

Return Value

Type: System.Int32

An integer value indicating the number of bytes read into the buffer.

Implements

IVsDataReader.GetBytes(Int32, [], Int32, Int32)

Exceptions

Exception	Condition
ArgumentOutOfRangeException	The index, bufferIndex, and/or length parameters are invalid.

Remarks

When data is presented by the DDEX provider in the form of raw bytes, call this method to read only a specified number of bytes into an existing client-side buffer. This provides better performance than simply retrieving the whole value, which causes all the data to be read and allocated in memory.

Notes to Inheritors:

The derived class must override this method.

Permissions

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.