DataTableReader.GetValue(Int32) Metodo

Definizione

Spazio dei nomi:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Ottiene il valore della colonna specificata nel 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

Parametri

ordinal
Int32

Ordinale di colonna in base zero.

Valori restituiti

Object

Valore della colonna specificata. Questo metodo restituisce DBNull per le colonne Null.

Eccezioni

ArgumentOutOfRangeException

L'indice passato non è compreso nell'intervallo compreso tra 0 e FieldCount - 1.

DeletedRowInaccessibleException

È stato effettuato un tentativo di recuperare dati da una riga eliminata.

InvalidOperationException

È stato effettuato un tentativo di leggere o accedere alle colonne in un oggetto chiuso DataTableReader .

Esempio

Nell'esempio seguente viene eseguita l'iterazione di tutte le colonne all'interno della riga corrente in un DataTableReaderoggetto , visualizzando il contenuto di ogni colonna e il nome della colonna. In genere, se la finalità consiste nell'usare tutte le colonne all'interno di una riga recuperata da , DataTableReaderè consigliabile usare il GetValues metodo , perché è più efficiente.

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

Commenti

Sebbene sia possibile chiamare IsDBNull per verificare se sono presenti valori Null prima di chiamare questo metodo, non è necessario eseguire questa operazione.

Si applica a