Compartir a través de

SqlCeDataReader.GetChars Method

  • Artículo

Lee una secuencia 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
Public Overrides Function GetChars ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Char(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long

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

public long GetChars (
    int ordinal, 
    long dataIndex, 
    char[] buffer, 
    int bufferIndex, 
    int length
)

public override function GetChars (
    ordinal : int, 
    dataIndex : long, 
    buffer : char[], 
    bufferIndex : int, 
    length : int
) : long

Parámetros

  • ordinal
    Ordinal de base cero de la columna.
  • dataIndex
    Índice de la fila desde el que va a comenzar la operación de lectura.
  • buffer
    Búfer en el que se van a copiar los datos.
  • bufferIndex
    Índice de buffer para comenzar la operación de lectura.
  • length
    Número de caracteres que se va a leer.

Valor devuelto

Número real de caracteres leídos.

Excepciones

Tipo de 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.

Notas

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 null, 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.

Seguridad para subprocesos

Todos los miembros (Compartidos en Microsoft Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Información de la versión
.NET Framework y NET Compact Framework
Se admite en 3.5
.NET Framework
Se admite en 3.0
.NET Compact Framework y .Net Framework
Se admite en 2.0

Vea también

Referencia

SqlCeDataReader Class
SqlCeDataReader Members
System.Data.SqlServerCe Namespace