DataTableReader.Item[] Eigenschap

Definitie

Hiermee haalt u de waarde van de opgegeven kolom op in de systeemeigen indeling.

Overloads

Name Description
Item[Int32]

Hiermee haalt u de waarde van de opgegeven kolom op in de systeemeigen indeling op basis van de kolomordinaal.

Item[String]

Hiermee haalt u de waarde van de opgegeven kolom op in de systeemeigen indeling op basis van de kolomnaam.

Item[Int32]

Hiermee haalt u de waarde van de opgegeven kolom op in de systeemeigen indeling op basis van de kolomordinaal.

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

Parameters

ordinal
Int32

De op nul gebaseerde kolomordinaal.

Waarde van eigenschap

De waarde van de opgegeven kolom in de systeemeigen indeling.

Uitzonderingen

De doorgegeven index lag buiten het bereik van 0 tot FieldCount - 1.

Voorbeelden

In het volgende voorbeeld wordt de inhoud van alle kolommen weergegeven, in alle rijen van de opgegeven DataTableReader. De code maakt gebruik van de methode Item[] (de indexeerfunctie in Microsoft C#) om de waarde op te halen die in elke kolom is opgenomen.

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

Opmerkingen

Deze overbelasting voor Item[] gedraagt zich identiek aan de GetValue methode.

Zie ook

Van toepassing op

Item[String]

Hiermee haalt u de waarde van de opgegeven kolom op in de systeemeigen indeling op basis van de kolomnaam.

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

Parameters

name
String

De naam van de kolom.

Waarde van eigenschap

De waarde van de opgegeven kolom in de systeemeigen indeling.

Uitzonderingen

De opgegeven naam is geen geldige kolomnaam.

Er is een poging gedaan om gegevens op te halen uit een verwijderde rij.

Er is geprobeerd een kolom in een gesloten DataTableReaderkolom te lezen of te openen.

Voorbeelden

Bij een DataTableReader en een kolomnaam retourneert de procedure GetValueByName de waarde van de opgegeven kolom. Voordat u deze procedure aanroept, moet u een nieuw DataTableReader exemplaar maken en de leesmethode ten minste één keer aanroepen om de rijaanwijzer op een rij met gegevens te plaatsen.

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

Opmerkingen

Eerst wordt een hoofdlettergevoelige zoekopdracht uitgevoerd. Als dit mislukt, wordt een tweede niet hoofdlettergevoelige zoekopdracht uitgevoerd.

Deze methode is niet gevoelig voor kana-breedte.

Deze overbelaste versie komt overeen met het aanroepen van Item[] de GetOrdinal methode en roept vervolgens de GetValue methode aan.

Van toepassing op