Método GetValues

Artigo
01/17/2011

Obtém todas as colunas de atributo da linha atual.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)

Sintaxe

'Declaração
Public Overrides Function GetValues ( _
    values As Object() _
) As Integer
'Uso
Dim instance As SqlCeDataReader
Dim values As Object()
Dim returnValue As Integer

returnValue = instance.GetValues(values)

public override int GetValues(
    Object[] values
)

public:
virtual int GetValues(
    array<Object^>^ values
) override

abstract GetValues : 
        values:Object[] -> int 
override GetValues : 
        values:Object[] -> int

public override function GetValues(
    values : Object[]
) : int

Parâmetros

values
Tipo: array<System. . :: . .Object> [] () [] []
Uma matriz de Object na qual as colunas de atributo devem ser copiadas.

Valor de retorno

Tipo: System. . :: . .Int32
O número de instâncias de Object na matriz.

Implementa

IDataRecord. . :: . .GetValues(array<Object> [] () [] [])

Exceções

Exceção	Condição
InvalidOperationException	A operação não é válida. O SqlCeDataReader pode ser posicionado após a última linha no conjunto de resultados.

Comentários

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

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

Este método retorna DBNull para colunas nulas do banco de dados.