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

Definição

Namespace:
System.Data.SqlClient
Assembly:
System.Data.dll

Lê um fluxo de caracteres do deslocamento de coluna especificado para o buffer como uma matriz começando no deslocamento de buffer fornecido.

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

Parâmetros

i
Int32

O ordinal de coluna baseado em zero.

dataIndex
Int64

O índice dentro do campo do qual iniciar a operação de leitura.

buffer
Char[]

O buffer no qual ler o fluxo de bytes.

bufferIndex
Int32

O índice no buffer local em que a operação de gravação deve ser iniciada.

length
Int32

O comprimento máximo a ser copiado para o buffer.

Retornos

Int64

O número real de caracteres lidos.

Implementações

GetChars(Int32, Int64, Char[], Int32, Int32)

Comentários

GetChars retorna o número de caracteres disponíveis no campo. Frequentemente, esse é o comprimento exato do campo. No entanto, o número retornado poderá ser menor que o comprimento verdadeiro do campo se GetChars já tiver sido usado para obter caracteres do campo. Esse pode ser o caso, por exemplo, se estiver SqlDataReader lendo uma estrutura de dados grande em um buffer. Para obter mais informações, consulte a SequentialAccess configuração para CommandBehavior.

O número real de caracteres lidos pode ser menor do que o comprimento solicitado, se o final do campo for atingido. Se você passar um buffer que seja null, GetChars retornará o comprimento de todo o campo em caracteres, não o tamanho restante com base no parâmetro de deslocamento do buffer.

Nenhuma conversão é executada; Portanto. os dados recuperados já devem ser uma matriz de caracteres.

Note

O GetChars método retorna 0 quando dataIndex é negativo.

Aplica-se a

Confira também