DataTableReader.Item[] Proprietà

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Ottiene il valore della colonna specificata nel formato nativo.

Overload

Item[Int32]	Ottiene il valore della colonna specificata nel formato nativo, data la posizione ordinale della colonna.
Item[String]	Ottiene il valore della colonna specificata nel formato nativo, dato il nome della colonna.

Item[Int32]

Source:

DataTableReader.cs

Ottiene il valore della colonna specificata nel formato nativo, data la posizione ordinale della 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à

Object

Valore della colonna specificata nel relativo formato nativo.

Eccezioni

IndexOutOfRangeException

L'indice passato non rientrava 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 specificato DataTableReader. Il codice usa il Item[] metodo (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[] il comportamento si comporta in modo identico al GetValue metodo.

Vedi anche

• GetValue(Int32)

Item[String]

Source:

DataTableReader.cs

Ottiene il valore della colonna specificata nel formato nativo, dato il 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à

Object

Valore della colonna specificata nel relativo formato nativo.

Eccezioni

ArgumentException

Il nome specificato non è un nome di colonna valido.

DeletedRowInaccessibleException

Si è tentato di recuperare dati da una riga eliminata.

InvalidOperationException

È stato effettuato un tentativo di lettura o di accesso a una colonna in una classe DataTableReader chiusa.

Esempio

Dato un e un DataTableReader nome di colonna, la procedura GetValueByName restituisce il valore della colonna specificata. Prima di chiamare questa procedura, è necessario creare una nuova DataTableReader istanza e chiamare il metodo Read almeno una volta per posizionare il puntatore della riga in 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 è insensibile a larghezza kana.

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