OleDbDataReader.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, comenzando en el desplazamiento de búfer dado.
public:
override long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
virtual long GetChars(int ordinal, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public override long GetChars (int ordinal, long dataIndex, char[]? buffer, int bufferIndex, int length);
public long GetChars (int ordinal, long dataIndex, char[] buffer, int bufferIndex, int length);
public override long GetChars (int ordinal, 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 (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Public Function GetChars (ordinal As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long
Parámetros
- ordinal
- Int32
Índice de la columna de base cero.
- dataIndex
- 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 van a copiar los datos.
- bufferIndex
- Int32
Índice del buffer
donde va a comenzar la operación de escritura.
- length
- Int32
Número de caracteres que se va a leer.
Devoluciones
Número real de caracteres que se leen.
Implementaciones
Comentarios
GetChars devuelve el número de caracteres disponibles en el campo . La mayoría de las veces 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, cuando OleDbDataReader está leyendo una estructura de datos de gran tamaño en un búfer. Para obtener más información, vea la SequentialAccess
configuración de CommandBehavior.
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 ser una matriz de caracteres.