Compartir a través de


SqlDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) Método

Definición

Obtiene el valor de la columna especificada por el ordinal como una matriz de objetos Byte.

public:
 virtual long GetBytes(int ordinal, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferOffset, int length);
public virtual long GetBytes (int ordinal, long fieldOffset, byte[] buffer, int bufferOffset, int length);
abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64
Public Overridable Function GetBytes (ordinal As Integer, fieldOffset As Long, buffer As Byte(), bufferOffset As Integer, length As Integer) As Long

Parámetros

ordinal
Int32

Ordinal basado en cero de la columna.

fieldOffset
Int64

Desplazamiento en el valor del campo para comenzar a recuperar bytes.

buffer
Byte[]

Búfer de destino en el que copiar los bytes.

bufferOffset
Int32

Desplazamiento en el búfer en el que se van a empezar a copiar los bytes.

length
Int32

El número de bytes que se deben copiar en el búfer.

Devoluciones

Número de bytes que se han copiado.

Implementaciones

Excepciones

ordinal es menor que 0 o mayor que el número de columnas (es decir, FieldCount).

La columna que especifica ordinal es nula.

Los tipos no coinciden.

Comentarios

Este método permite obtener un valor binario en una sola llamada o en fragmentos. Obtener el valor en fragmentos es útil para valores grandes o valores de tamaño desconocido.

Para obtener el valor en varios fragmentos, asigne una matriz de bytes del tamaño del fragmento y llame GetBytes repetidamente, ajustando el fieldOffset parámetro según corresponda en cada llamada.

Se aplica a