Compartir a través de


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

Definición

Lee una secuencia de caracteres del desplazamiento de columna especificado en el búfer como una matriz, comenzando en el desplazamiento de búfer dado.

public:
 long GetChars(int i, long fieldoffset, cli::array <char> ^ buffer, int bufferoffset, int length);
public long GetChars (int i, long fieldoffset, char[] buffer, int bufferoffset, int length);
public long GetChars (int i, long fieldoffset, char[]? buffer, int bufferoffset, int length);
abstract member GetChars : int * int64 * char[] * int * int -> int64
Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As Long

Parámetros

i
Int32

Índice de la columna de base cero.

fieldoffset
Int64

Índice de la fila desde el que se va a comenzar la operación de lectura.

buffer
Char[]

Búfer en el que se va a leer la secuencia de bytes.

bufferoffset
Int32

Índice de buffer para iniciar la operación de lectura.

length
Int32

Número de bytes que se va a leer.

Devoluciones

Número real de caracteres que se leen.

Excepciones

El índice pasado se encontraba fuera del intervalo de 0 a FieldCount.

Comentarios

GetChars devuelve el número de caracteres disponibles en el campo. Con frecuencia, esta es la longitud exacta del campo. Sin embargo, el número devuelto puede ser menor que la longitud exacta del campo si GetChars ya se ha usado para obtener caracteres del campo.

Si pasa un búfer que es null, GetChars devuelve la longitud del campo en caracteres.

No se realizan conversiones; por lo tanto, los datos recuperados ya deben constituir una matriz de caracteres.

Se aplica a