DataTableReader.Item[] Eigenschaft

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Ruft den Wert der angegebenen Spalte im systemeigenen Format ab.

Überlädt

Item[Int32]	Ruft bei angegebener Spaltenordnungszahl den Wert der angegebenen Spalte im systemeigenen Format ab.
Item[String]	Ruft bei angegebenem Spaltennamen den Wert der angegebenen Spalte im systemeigenen Format ab.

Item[Int32]

Quelle:

DataTableReader.cs

Ruft bei angegebener Spaltenordnungszahl den Wert der angegebenen Spalte im systemeigenen Format ab.

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

Parameter

ordinal

Int32

Die nullbasierte Ordnungszahl der Spalte.

Eigenschaftswert

Object

Der Wert der angegebenen Spalte im systemeigenen Format.

Ausnahmen

IndexOutOfRangeException

Der übergebene Index lag außerhalb des Bereichs von 0 bis FieldCount -1.

Beispiele

Im folgenden Beispiel wird der Inhalt aller Spalten in allen Zeilen des angegebenen DataTableReaderangezeigt. Der Code verwendet die Item[] -Methode (den Indexer in Microsoft C#), um den Wert abzurufen, der in jeder Spalte enthalten ist.

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

Hinweise

Diese Überladung für Item[] verhält sich identisch mit der GetValue -Methode.

Weitere Informationen

• GetValue(Int32)

Item[String]

Quelle:

DataTableReader.cs

Ruft bei angegebenem Spaltennamen den Wert der angegebenen Spalte im systemeigenen Format ab.

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

Parameter

name

String

Der Name der Spalte.

Eigenschaftswert

Object

Der Wert der angegebenen Spalte im systemeigenen Format.

Ausnahmen

ArgumentException

Der angegebene Name ist kein gültiger Spaltenname.

DeletedRowInaccessibleException

Es wurde versucht, Daten aus einer gelöschten Zeile abzurufen.

InvalidOperationException

Es wurde versucht, eine Spalte in einem geschlossenen DataTableReader zu lesen oder darauf zuzugreifen.

Beispiele

Bei einem DataTableReader Spaltennamen und einem Spaltennamen gibt die GetValueByName-Prozedur den Wert der angegebenen Spalte zurück. Bevor Sie diese Prozedur aufrufen, müssen Sie eine neue DataTableReader instance erstellen und die read-Methode mindestens einmal aufrufen, um den Zeilenzeiger auf einer Datenzeile zu positionieren.

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

Hinweise

Zuerst wird nach Groß-/Kleinschreibung gesucht. Wenn ein Fehler auftritt, wird eine zweite Suche ohne Beachtung der Groß-/Kleinschreibung durchgeführt.

Diese Methode ist kana-width nicht empfindlich.

Diese überladene Version von Item[] entspricht dem Aufrufen der GetOrdinal -Methode und anschließendem Aufrufen der GetValue -Methode.