Compartilhar via


SqlDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Método

Definição

Obtém o valor da coluna especificada pelo ordinal como uma matriz de objetos Char.

public:
 virtual long GetChars(int ordinal, long fieldOffset, cli::array <char> ^ buffer, int bufferOffset, int length);
public virtual long GetChars (int ordinal, long fieldOffset, char[] buffer, int bufferOffset, int length);
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As Long

Parâmetros

ordinal
Int32

O ordinal com base em zero da coluna.

fieldOffset
Int64

O deslocamento no valor do campo para começar a recuperar caracteres.

buffer
Char[]

O buffer de destino no qual copiar caracteres.

bufferOffset
Int32

O deslocamento no buffer no qual começar a copiar caracteres.

length
Int32

O número de caracteres a serem copiados no buffer.

Retornos

O número de caracteres copiados.

Implementações

Exceções

O ordinal é menor que 0 ou maior que o número de colunas (ou seja, FieldCount).

A coluna especificada por ordinal é nula.

Há tipos incompatíveis.

Comentários

Esse método permite que você obtenha um valor de caractere em uma única chamada ou em partes. Obter o valor em partes é útil para valores grandes ou valores de tamanho desconhecido.

Para obter o valor em várias partes, aloque uma matriz char do tamanho da parte e chame GetChars ajustando repetidamente o fieldOffset parâmetro adequadamente em cada chamada.

Aplica-se a