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

Definición

Espacio de nombres:
System.Data.Odbc
Ensamblado:
System.Data.Odbc.dll
Ensamblado:
System.Data.dll
Paquete:
System.Data.Odbc v11.0.0-preview.4.26230.115
Source:
OdbcDataReader.cs
Source:
OdbcDataReader.cs
Source:
OdbcDataReader.cs
Source:
OdbcDataReader.cs

Lee una secuencia de caracteres del desplazamiento de columna especificado en el búfer como una matriz, empezando por el desplazamiento de búfer determinado.

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

Ordinal de columna de base cero.

dataIndex
Int64

Índice dentro de la fila donde se va a iniciar la operación de lectura.

buffer
Char[]

Búfer en el que se van a copiar los datos.

bufferIndex
Int32

Índice dentro de donde buffer se va a iniciar la operación de escritura.

length
Int32

Número de caracteres que se van a leer.

Devoluciones

Int64

Número real de caracteres leídos.

Implementaciones

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

Comentarios

GetChars devuelve el número de caracteres disponibles en el campo. La mayoría de las veces 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 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.

Note

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

Se aplica a

Consulte también