Método AdomdDataReader.GetChars
Retorna uma matriz de objetos Char que contêm um fluxo de valores da coluna especificada.
Namespace: Microsoft.AnalysisServices.AdomdServer
Assembly: msmgdsrv (em msmgdsrv.dll)
Sintaxe
'Declaração
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
A posição ordinal de base zero da coluna a ser recuperada.
- fieldOffset
Tipo: Int64
O índice de base zero dentro da coluna da qual começar a ler dados.
- buffer
Tipo: array<Char[]
O buffer no qual deve-se ler o fluxo de caracteres.
- bufferoffset
Tipo: Int32
O índice de base zero dentro do buffer do qual começar a gravar dados.
- length
Tipo: Int32
O número de caracteres a serem lidos da coluna.
Valor de retorno
Tipo: Int64
Um valor Long que contém o número de caracteres realmente lidos da coluna.
Implementa
IDataRecordGetChars(Int32, Int64, Char, Int32, Int32)
Exceções
| Exceção | Condição |
|---|---|
| [IndexOutOfRangeException] | O valor de dataIndex é superior a Int32.MaxValue. O valor de bufferIndex é inferior a 0 ou superior ao total de length e o comprimento de buffer. Para obter mais informações sobre essa exceção, consulte IndexOutOfRangeException Class. |
Comentários
O método GetChars retorna o número de caracteres disponíveis no campo. Na maioria dos casos, esse é o comprimento exato do campo. No entanto, o número retornado pode ser menor que o comprimento do campo true se o GetChars já tiver sido usado para obter caracteres do campo.
Se você passar uma referência nula (Nothing no Microsoft Visual Basic) no parâmetro buffer, o GetBytes retornará o comprimento da coluna em caracteres.
Nenhuma conversão é executada; portanto, os dados recuperados já devem ser uma matriz de caractere.