Compartir a través de


SqlCeResultSet.GetChars Método

Copia una longitud de caracteres (tipo char) en el búfer empezando en una posición dada del campo especificado.

Espacio de nombres:  System.Data.SqlServerCe
Ensamblado:  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Sintaxis

'Declaración
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 SqlCeResultSet
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)
public override long GetChars(
    int ordinal,
    long dataIndex,
    char[] buffer,
    int bufferIndex,
    int length
)
public:
virtual long long GetChars(
    int ordinal, 
    long long dataIndex, 
    array<wchar_t>^ buffer, 
    int bufferIndex, 
    int length
) override
abstract GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
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
    Posición ordinal del campo del que se van a recuperar datos.
  • dataIndex
    Tipo: System.Int64
    Desplazamiento (en caracteres) dentro del campo a partir del cual se van a empezar a copiar datos.
  • buffer
    Tipo: array<System.Char[]
    Búfer en el que se van a copiar los datos.
  • bufferIndex
    Tipo: System.Int32
    El desplazamiento en el búfer a partir del cual se inicia la copia.
  • length
    Tipo: System.Int32
    Número máximo de bytes que se van a copiar.

Valor devuelto

Tipo: System.Int64
Número real de caracteres copiados.

Implementa

IDataRecord.GetChars(Int32, Int64, array<Char[], Int32, Int32)

Comentarios

Esta función devuelve el número real de caracteres copiados, que puede ser menor que la longitud solicitada si antes se alcanza el final del campo.

Si se pasa un búfer nulo, GetChars devuelve la longitud del campo en caracteres.

Si el comando se ejecuta con un comportamiento de comando de SequentialAccess, las llamadas a GetChars deben especificar lecturas crecientes secuencialmente; de lo contrario, se produce una excepción.

Si no existe ningún campo en la posición ordinal especificada, se produce una excepción.

Vea también

Referencia

SqlCeResultSet Clase

Espacio de nombres System.Data.SqlServerCe