Compartir a través de


SqlDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Método

Definición

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

public:
 virtual long GetChars(int ordinal, long fieldOffset, cli::array <char> ^ buffer, int bufferOffset, int length);
public virtual long GetChars (int ordinal, long fieldOffset, char[] buffer, int bufferOffset, int length);
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), 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 caracteres.

buffer
Char[]

Búfer de destino en el que se van a copiar los caracteres.

bufferOffset
Int32

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

length
Int32

Número de caracteres que se van a copiar en el búfer.

Devoluciones

Número de caracteres copiados.

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 de carácter 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 char del tamaño del fragmento y llame GetChars repetidamente al ajuste del fieldOffset parámetro según corresponda en cada llamada.

Se aplica a