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

Referencia

Definición

Espacio de nombres:: System.Data.SqlClient

Ensamblado:: System.Data.SqlClient.dll

Ensamblado:: System.Data.dll

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í.

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:
 override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);

public:
 virtual long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);

public override long GetChars (int i, long dataIndex, char[] buffer, int bufferIndex, int length);

public long GetChars (int i, long dataIndex, char[] buffer, int bufferIndex, int length);

override this.GetChars : int * int64 * char[] * int * int -> int64

abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64

Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Public Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

Parámetros

i: Int32

Índice de la columna de base cero.

dataIndex: Int64

Índice dentro del campo a partir del cual debe comenzar la operación de lectura.

buffer: Char[]

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

bufferIndex: Int32

Índice del buffer donde va a comenzar la operación de escritura.

length: Int32

Longitud máxima que se puede copiar en el búfer.

Devoluciones

Int64

Número real de caracteres que se leen.

Implementaciones

GetChars(Int32, Int64, Char[], Int32, Int32)

Comentarios

GetChars devuelve el número de caracteres disponibles en el campo . Con frecuencia, esta es la longitud exacta del campo. Sin embargo, el valor devuelto puede ser menor que la longitud real del campo si GetChars ya se usó para obtener caracteres del campo. Esto puede ser el caso, por ejemplo, si SqlDataReader está leyendo una estructura de datos grande en un búfer. Para obtener más información, vea la SequentialAccess configuración de CommandBehavior.

El número real de caracteres leídos puede ser menor que la longitud solicitada, si se alcanza el final del campo. Si pasa un búfer que es null, GetChars devuelve la longitud del campo completo en caracteres, no el tamaño restante en función del parámetro de desplazamiento del búfer.

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

Nota

El GetChars método devuelve 0 cuando dataIndex es negativo.

Se aplica a