DataTableReader.Item[] Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 .