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.Reads a stream of characters from the specified column offset into the buffer as an array, starting at the given buffer offset.

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);
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.The zero-based column ordinal.

fieldoffset
Int64

Índice de la fila desde el que se va a comenzar la operación de lectura.The index within the row from which to start the read operation.

buffer
Char[]

Búfer en el que se va a leer la secuencia de bytes.The buffer into which to read the stream of bytes.

bufferoffset
Int32

Índice de buffer para iniciar la operación de lectura.The index for buffer to start the read operation.

length
Int32

Número de bytes que se va a leer.The number of bytes to read.

Devoluciones

Número real de caracteres que se leen.The actual number of characters read.

Excepciones

El índice pasado se encontraba fuera del intervalo de 0 a FieldCount.The index passed was outside the range of 0 through FieldCount.

Comentarios

GetChars devuelve el número de caracteres disponibles en el campo.GetChars returns the number of available characters in the field. Con frecuencia, es la longitud exacta del campo.Frequently this is the exact length of the field. Sin embargo, el número devuelto puede ser menor que la longitud exacta del campo si ya se ha utilizado GetChars para obtener caracteres del campo.However, the number returned may be less than the exact length of the field if GetChars has already been used to obtain characters from the field.

Si se pasa un búfer null, GetChars devuelve la longitud del campo en caracteres.If you pass a buffer that is null, GetChars returns the length of the field in characters.

No se realizan conversiones; por lo tanto, los datos recuperados ya deben constituir una matriz de caracteres.No conversions are performed; therefore the data retrieved must already be a character array.

Se aplica a