OracleDataReader.GetValues(Object[]) Método

Definição

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Popula uma matriz de objetos com os valores da coluna da linha atual.

public:
 override int GetValues(cli::array <System::Object ^> ^ values);

public override int GetValues (object[] values);

override this.GetValues : obj[] -> int

Public Overrides Function GetValues (values As Object()) As Integer

Parâmetros

values

Object[]

Uma matriz do tipo Object para a qual as colunas de atributo serão copiadas.

Retornos

Int32

O número de instâncias de Object na matriz.

Exceções

OracleException

O valor é muito grande para ser armazenado em .NET Decimal.

Comentários

Para a maioria dos aplicativos, o GetValues método fornece um meio eficiente para recuperar todas as colunas, em vez de recuperar cada coluna individualmente.

Você pode passar uma Object matriz que contém menos do que o número de colunas contidas na linha resultante. Somente a quantidade de dados que a Object matriz contém é copiada para a matriz. Você também pode passar uma Object matriz cujo comprimento é maior que o número de colunas contidas na linha resultante.

Esse método retorna DBNull para colunas de banco de dados nulas. O valor retornado na Object matriz pode ser o resultado da conversão do tipo de dados Number da Oracle para o tipo decimal .NET. Se o valor for muito grande para ser armazenado no Decimal do .NET, esse método gerará um OracleException que é uma exceção de estouro.