IDataRecord.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, empezando por el desplazamiento del búfer especificado.
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 -> int64Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As LongParámetros
- i
- Int32
Ordinal de columna de base cero.
- fieldoffset
- Int64
Índice dentro de la fila desde la 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.
- bufferoffset
- Int32
Índice para buffer iniciar la operación de lectura.
- length
- Int32
Número de bytes que se van a leer.
Devoluciones
Número real de caracteres leídos.
Excepciones
El índice pasado estaba 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 realiza ninguna conversión; por lo tanto, los datos recuperados ya deben ser una matriz de caracteres.
