DataTableReader.Item[] Proprietà

Definizione

Ottiene il valore della colonna specificata nel formato nativo.

Overload

Nome Descrizione
Item[Int32]

Ottiene il valore della colonna specificata nel formato nativo in base all'ordinale di colonna.

Item[String]

Ottiene il valore della colonna specificata nel formato nativo in base al nome della colonna.

Item[Int32]

Ottiene il valore della colonna specificata nel formato nativo in base all'ordinale di colonna.

public:
 virtual property System::Object ^ default[int] { System::Object ^ get(int ordinal); };
public override object this[int ordinal] { get; }
member this.Item(int) : obj
Default Public Overrides ReadOnly Property Item(ordinal As Integer) As Object

Parametri

ordinal
Int32

Ordinale di colonna in base zero.

Valore della proprietà

Valore della colonna specificata nel formato nativo.

Eccezioni

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

Esempio

Nell'esempio seguente viene visualizzato il contenuto di tutte le colonne, in tutte le righe dell'oggetto DataTableReaderfornito. Il codice usa il metodo Item[] (indicizzatore, in Microsoft C#) per recuperare il valore contenuto in ogni colonna.

private static void DisplayItems(DataTableReader reader)
{
    int rowNumber = 0;
    while (reader.Read())
    {
        Console.WriteLine("Row " + rowNumber);
        for (int i = 0; i < reader.FieldCount; i++)
        {
            Console.WriteLine("{0}: {1}", reader.GetName(i), reader[i]);
        }
        rowNumber++;
    }
}
Private Sub DisplayItems(ByVal reader As DataTableReader)
   Dim rowNumber As Integer
   While reader.Read()
      Console.WriteLine("Row " & rowNumber)
      For i As Integer = 0 To reader.FieldCount - 1
         Console.WriteLine("{0}: {1}", reader.GetName(i), reader.Item(i))
      Next
      rowNumber += 1
   End While
End Sub

Commenti

Questo overload per Item[] si comporta in modo identico al GetValue metodo .

Vedi anche

Si applica a

Item[String]

Ottiene il valore della colonna specificata nel formato nativo in base al nome della colonna.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ name); };
public override object this[string name] { get; }
member this.Item(string) : obj
Default Public Overrides ReadOnly Property Item(name As String) As Object

Parametri

name
String

Nome della colonna.

Valore della proprietà

Valore della colonna specificata nel formato nativo.

Eccezioni

Il nome specificato non è un nome di colonna valido.

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

È stato effettuato un tentativo di lettura o accesso a una colonna in un oggetto chiuso DataTableReader.

Esempio

Dato un DataTableReader nome di colonna e , la routine GetValueByName restituisce il valore della colonna specificata. Prima di chiamare questa procedura, è necessario creare una nuova DataTableReader istanza e chiamare il relativo metodo Read almeno una volta per posizionare il puntatore di riga su una riga di dati.

private static object GetValueByName(
    DataTableReader reader, string columnName)
{
    // Consider when to use a procedure like this one carefully:
    // if  you're going to retrieve information from a column
    // in a loop, it would be better to retrieve the column
    // ordinal once, store the value, and use the methods
    // of the DataTableReader class directly.
    // Use this string-based indexer sparingly.
    object columnValue = null;

    try
    {
        columnValue = reader[columnName];
    }
    catch (ArgumentException ex)
    {
        // Throw all other errors back out to the caller.
        columnValue = null;
    }
    return columnValue;
}
Private Function GetValueByName( _
   ByVal reader As DataTableReader, _
   ByVal columnName As String) As Object

   ' Consider when to use a procedure like this one carefully:
   ' If you're going to retrieve information from a column
   ' in a loop, it would be better to retrieve the column
   ' ordinal once, store the value, and use the methods
   ' of the DataTableReader class directly. 
   ' Use Item(columnName) sparingly.
   Dim columnValue As Object

   Try
      columnValue = reader.Item(columnName)
   Catch ex As ArgumentException
      ' Throw all other errors back out to the caller.
      columnValue = Nothing
   End Try
   Return columnValue
End Function

Commenti

Viene eseguita prima una ricerca con distinzione tra maiuscole e minuscole. Se ha esito negativo, viene eseguita una seconda ricerca senza distinzione tra maiuscole e minuscole.

Questo metodo è senza distinzione di larghezza kana.

Questa versione di overload di Item[] corrisponde alla chiamata al GetOrdinal metodo e successivamente alla chiamata al GetValue metodo .

Si applica a