SqlDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> int64Public Overridable Function GetBytes (ordinal As Integer, fieldOffset As Long, buffer As Byte(), bufferOffset As Integer, length As Integer) As LongPará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.