SqlDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Lê um fluxo de caracteres do deslocamento de coluna especificado para o buffer como um array a partir do deslocamento do buffer dado.
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 -> int64override this.GetChars : int * int64 * char[] * int * int -> int64Public Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As LongPublic Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As LongParâmetros
- i
- Int32
O ordinal da coluna baseada em zero.
- dataIndex
- Int64
O índice dentro do campo a partir do qual iniciar a operação de leitura.
- buffer
- Char[]
O buffer para ler o fluxo de bytes.
- bufferIndex
- Int32
O índice dentro do buffer local onde a operação de escrita deve começar.
- length
- Int32
O comprimento máximo para copiar para o buffer.
Devoluções
O número real de caracteres lidos.
Implementações
Observações
GetChars devolve o número de caracteres disponíveis no campo. Frequentemente, este é o comprimento exato do campo. No entanto, o número devolvido pode ser inferior ao comprimento real do campo se GetChars já tiver sido usado para obter caracteres do campo. Isto pode acontecer, por exemplo, se o SqlDataReader estiver a ler uma grande estrutura de dados num buffer. Para mais informações, consulte a SequentialAccess definição para CommandBehavior.
O número real de caracteres lidos pode ser inferior ao comprimento solicitado, se o fim do campo for atingido. Se passar um buffer que é null, GetChars devolve o comprimento de todo o campo em caracteres, não o tamanho restante baseado no parâmetro de offset do buffer.
Não são realizadas conversões; Portanto. Os dados recuperados já devem ser um array de caracteres.
Note
O GetChars método devolve 0 quando dataIndex é negativo.