SqlDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> int64Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As LongParâ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.