SqlDataReader.GetChars(Int32, Int64, Char[], 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í.
Lee una secuencia de caracteres del desplazamiento de columna especificado en el búfer como una matriz que comienza en el desplazamiento del búfer especificado.
public:
virtual long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);public:
override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);public long GetChars(int i, long dataIndex, char[] buffer, int bufferIndex, int length);public override long GetChars(int i, long dataIndex, char[] buffer, int bufferIndex, int length);abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64override this.GetChars : int * int64 * char[] * int * int -> int64Public Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As LongPublic Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As LongParámetros
- i
- Int32
Ordinal de columna de base cero.
- dataIndex
- Int64
Índice dentro del campo desde el que se va a iniciar la operación de lectura.
- buffer
- Char[]
Búfer en el que se va a leer el flujo de bytes.
- bufferIndex
- Int32
Índice dentro de donde buffer se va a iniciar la operación de escritura.
- length
- Int32
Longitud máxima que se va a copiar en el búfer.
Devoluciones
Número real de caracteres leídos.
Implementaciones
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 verdadera del campo si GetChars ya se ha usado 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 realiza ninguna conversión; por lo tanto. los datos recuperados ya deben ser una matriz de caracteres.
Note
El GetChars método devuelve 0 cuando dataIndex es negativo.