SqlDataRecord.GetValues(Object[]) Método

Definição

Namespace:

Microsoft.Data.SqlClient.Server

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

Retorna os valores de todas as colunas no registro, expressos como tipos do CLR (Common Language Runtime), em uma matriz.

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

public virtual int GetValues (object[] values);

abstract member GetValues : obj[] -> int
override this.GetValues : obj[] -> int

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

Parâmetros

values

Object[]

A matriz na qual copiar os valores da coluna de valores.

Retornos

Int32

Um Int32 que indica o número de colunas copiadas.

Implementações

GetValues(Object[])

Exceções

ArgumentNullException

values é null.

InvalidCastException

Há tipos incompatíveis.

Comentários

Os valores de tipo CLR da coluna são copiados para a values matriz que é passada como um parâmetro. Para colunas com valor nulo, Value é retornado.

O comprimento da values matriz não precisa corresponder ao número de colunas no registro. Se o comprimento da matriz for maior que o número de colunas, todos os valores de coluna serão copiados para a matriz; se for menor, somente o número de comprimento da matriz de valores de coluna será copiado para a matriz, começando no valor da coluna com ordinal 0.