DataTableReader.GetValue(Int32) Método

Referência

Definição

Namespace:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Origem:: DataTableReader.cs

Origem:: DataTableReader.cs

Origem:: DataTableReader.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém o valor da coluna especificada em seu formato nativo.

public:
 override System::Object ^ GetValue(int ordinal);

public override object GetValue (int ordinal);

override this.GetValue : int -> obj

Public Overrides Function GetValue (ordinal As Integer) As Object

Parâmetros

ordinal: Int32

O ordinal da coluna baseado em zero.

Retornos

Object

O valor da coluna especificada. Esse método retorna DBNull para colunas nulas.

Exceções

ArgumentOutOfRangeException

O índice passado estava fora do intervalo de 0 a FieldCount -1.

DeletedRowInaccessibleException

Foi feita uma tentativa de recuperar dados de uma linha excluída.

InvalidOperationException

Foi feita uma tentativa de ler ou acessar colunas em um DataTableReader fechado.

Exemplos

O exemplo a seguir itera em todas as colunas dentro da linha atual em um DataTableReader, exibindo o conteúdo de cada coluna e o nome da coluna. Em geral, se sua intenção for trabalhar com todas as colunas dentro de uma linha recuperada por um DataTableReader, considere usar o GetValues método , pois ele é mais eficiente.

private static void GetAllValues(DataTableReader reader)
{
    // Given a DataTableReader, retrieve the value of
    // each column, and display the name, value, and type.
    // Make sure you have called reader.Read at least once before
    // calling this procedure.

    // Loop through all the columns.
    object value = null;
    for (int i = 0; i < reader.FieldCount; i++)
    {
        if (reader.IsDBNull(i))
        {
            value = "<NULL>";
        }
        else
        {
            value = reader.GetValue(i);
        }
        Console.WriteLine("{0}: {1} ({2})", reader.GetName(i),
            value, reader.GetFieldType(i).Name);
    }
}

Private Sub GetAllValues(ByVal reader As DataTableReader)

   ' Given a DataTableReader, retrieve the value of 
   ' each column, and display the name, value, and type.
   ' Make sure you've called reader.Read at least once before
   ' calling this procedure.
   ' Loop through all the columns.
   Dim value As Object
   For i As Integer = 0 To reader.FieldCount - 1
      If reader.IsDBNull(i) Then
         value = "<NULL>"
      Else
         value = reader.GetValue(i)
      End If
      Console.WriteLine("{0}: {1} ({2})", reader.GetName(i), _
         value, reader.GetFieldType(i).Name)
   Next
End Sub

Comentários

Embora você possa chamar IsDBNull para ver se há valores nulos antes de chamar esse método, você não precisa fazer isso.

Aplica-se a

Partilhar via