AdomdDataReader.GetChars Método
Devuelve una matriz de objetos Char que contiene un flujo de valores de la columna especificada.
Espacio de nombres: Microsoft.AnalysisServices.AdomdServer
Ensamblado: msmgdsrv (en msmgdsrv.dll)
Sintaxis
'Declaración
Public Function GetChars ( _
i As Integer, _
fieldOffset As Long, _
buffer As Char(), _
bufferoffset As Integer, _
length As Integer _
) As Long
'Uso
Dim instance As AdomdDataReader
Dim i As Integer
Dim fieldOffset As Long
Dim buffer As Char()
Dim bufferoffset As Integer
Dim length As Integer
Dim returnValue As Long
returnValue = instance.GetChars(i, fieldOffset, _
buffer, bufferoffset, length)
public long GetChars(
int i,
long fieldOffset,
char[] buffer,
int bufferoffset,
int length
)
public:
virtual long long GetChars(
int i,
long long fieldOffset,
array<wchar_t>^ buffer,
int bufferoffset,
int length
) sealed
abstract GetChars :
i:int *
fieldOffset:int64 *
buffer:char[] *
bufferoffset:int *
length:int -> int64
override GetChars :
i:int *
fieldOffset:int64 *
buffer:char[] *
bufferoffset:int *
length:int -> int64
public final function GetChars(
i : int,
fieldOffset : long,
buffer : char[],
bufferoffset : int,
length : int
) : long
Parámetros
- i
Tipo: Int32
La posición ordinal basada en cero de la columna que se va a recuperar.
- fieldOffset
Tipo: Int64
El índice basado en cero dentro de la columna en la que se va a empezar a leer datos.
- buffer
Tipo: array<Char[]
El búfer en el que se va a leer el flujo de caracteres.
- bufferoffset
Tipo: Int32
El índice basado en cero dentro del búfer en el que se va a empezar a escribir datos.
- length
Tipo: Int32
El número de caracteres que se van a leer en la columna.
Valor devuelto
Tipo: Int64
Un valor de tipo Long que contiene el número de caracteres leídos realmente en la columna.
Implementa
IDataRecordGetChars(Int32, Int64, Char, Int32, Int32)
Excepciones
| Excepción | Condición |
|---|---|
| [IndexOutOfRangeException] | El valor dedataIndex es mayor que Int32.MaxValue. El valor bufferIndex es menor que 0 o mayor que el total de length y la longitud de buffer. Para obtener más información acerca de esta excepción, vea IndexOutOfRangeException Class. |
Comentarios
El método GetChars devuelve el número de caracteres disponibles en el campo. En la mayoría de los casos, es la longitud exacta del campo. Sin embargo, el número devuelto puede ser menor que la longitud real del campo si ya se ha utilizado previamente GetChars para obtener caracteres del campo.
Si pasa una referencia NULL (Nothing en Microsoft Visual Basic) en el parámetro buffer, GetBytes devuelve la longitud de la columna en caracteres.
No se realiza ninguna conversión; por tanto, los datos recuperados deben ser ya una matriz de caracteres.