Compartir a través de


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

Definición

Lee una secuencia de caracteres del desplazamiento de la columna especificada en el búfer como 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);
public override 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 de la fila donde 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, si OdbcDataReader está leyendo una estructura de datos grande en un búfer. Para obtener más información, vea la SequentialAccess configuración de CommandBehavior.

Si pasa un búfer que es un valor NULL, GetChars devuelve la longitud del campo en caracteres.

Las conversiones se realizan en función de las funcionalidades subyacentes del controlador ODBC. Si no se admite la conversión, se producirá un error en la llamada al método.

Nota

No se producirá ninguna excepción si el valor de está fuera de bufferIndex la matriz. No se leerá ningún dato y el método devolverá 0.

Se aplica a

Consulte también