SqlCeDataReader.GetChars Método
Lee un flujo de caracteres del desplazamiento de columna que se haya especificado en el búfer como matriz, comenzando en el desplazamiento de búfer dado.
Espacio de nombres: System.Data.SqlServerCe
Ensamblado: System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)
Sintaxis
'Declaración
<SecurityTreatAsSafeAttribute> _
<SecurityCriticalAttribute> _
Public Overrides Function GetChars ( _
ordinal As Integer, _
dataIndex As Long, _
buffer As Char(), _
bufferIndex As Integer, _
length As Integer _
) As Long
'Uso
Dim instance As SqlCeDataReader
Dim ordinal As Integer
Dim dataIndex As Long
Dim buffer As Char()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long
returnValue = instance.GetChars(ordinal, _
dataIndex, buffer, bufferIndex, length)
[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public override long GetChars(
int ordinal,
long dataIndex,
char[] buffer,
int bufferIndex,
int length
)
[SecurityTreatAsSafeAttribute]
[SecurityCriticalAttribute]
public:
virtual long long GetChars(
int ordinal,
long long dataIndex,
array<wchar_t>^ buffer,
int bufferIndex,
int length
) override
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
abstract GetChars :
ordinal:int *
dataIndex:int64 *
buffer:char[] *
bufferIndex:int *
length:int -> int64
[<SecurityTreatAsSafeAttribute>]
[<SecurityCriticalAttribute>]
override GetChars :
ordinal:int *
dataIndex:int64 *
buffer:char[] *
bufferIndex:int *
length:int -> int64
public override function GetChars(
ordinal : int,
dataIndex : long,
buffer : char[],
bufferIndex : int,
length : int
) : long
Parámetros
- ordinal
Tipo: System.Int32
Ordinal de base cero de la columna.
- dataIndex
Tipo: System.Int64
Índice de la fila desde el que va a comenzar la operación de lectura.
- buffer
Tipo: array<System.Char[]
Búfer en el que se van a copiar los datos.
- bufferIndex
Tipo: System.Int32
Índice de buffer para comenzar la operación de lectura.
- length
Tipo: System.Int32
Número de caracteres que se va a leer.
Valor devuelto
Tipo: System.Int64
Número real de caracteres leídos.
Implementa
IDataRecord.GetChars(Int32, Int64, array<Char[], Int32, Int32)
Excepciones
| Excepción | Condición |
|---|---|
| InvalidOperationException | La operación no es válida. SqlCeDataReader puede colocarse detrás de la última fila del conjunto de resultados. |
Comentarios
GetChars devuelve el número de caracteres disponibles en el campo. En la mayoría de los casos, se trata de la longitud exacta del campo. Sin embargo, el valor devuelto puede ser menor que la longitud del campo si GetChars ya se ha utilizado para obtener caracteres del campo. Esto puede suceder, por ejemplo, cuando el objeto SqlCeDataReader está leyendo una gran estructura de datos en un búfer. Para obtener más información, vea el valor de SequentialAccess para CommandBehavior.
Si se pasa un búfer que es nulles una referencia NULL (Nothing en Visual Basic)., GetChars devuelve la longitud del campo en caracteres.
No se realizan conversiones, por lo que los datos recuperados deben presentarse en forma de matriz de caracteres.