DataTableReader.Item[String] Właściwość

Definicja

Pobiera wartość określonej kolumny w formacie natywnym.Gets the value of the specified column in its native format.

Przeciążenia

Item[Int32]

Pobiera wartość określonej kolumny w formacie natywnym, w którym znajduje się numer porządkowy kolumny.Gets the value of the specified column in its native format given the column ordinal.

Item[String]

Pobiera wartość określonej kolumny w formacie natywnym, w którym znajduje się nazwa kolumny.Gets the value of the specified column in its native format given the column name.

Item[Int32]

Pobiera wartość określonej kolumny w formacie natywnym, w którym znajduje się numer porządkowy kolumny.Gets the value of the specified column in its native format given the column ordinal.

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

Parametry

ordinal
Int32

Numer porządkowy kolumny liczony od zera.The zero-based column ordinal.

Wartość właściwości

Wartość określonej kolumny w formacie natywnym.The value of the specified column in its native format.

Wyjątki

Przekazano indeks poza zakresem od 0 do FieldCount-1.The index passed was outside the range of 0 to FieldCount - 1.

Przykłady

Poniższy przykład wyświetla zawartość wszystkich kolumn we wszystkich wierszach z podanej DataTableReader.The following example displays the contents of all the columns, in all the rows from the supplied DataTableReader. Kod używa metody Item[String] (indeksator, w firmie Microsoft C#) do pobrania wartości, która jest zawarta w każdej kolumnie.The code uses the Item[String] method (the indexer, in Microsoft C#) to retrieve the value that is contained in each column.

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

Uwagi

To Przeciążenie dla Item[String] zachowuje się identycznie z metodą GetValue.This overload for Item[String] behaves identically to the GetValue method.

Zobacz też

Item[String]

Pobiera wartość określonej kolumny w formacie natywnym, w którym znajduje się nazwa kolumny.Gets the value of the specified column in its native format given the column name.

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

Parametry

name
String

Nazwa kolumny.The name of the column.

Wartość właściwości

Wartość określonej kolumny w formacie natywnym.The value of the specified column in its native format.

Wyjątki

Podana nazwa nie jest prawidłową nazwą kolumny.The name specified is not a valid column name.

Podjęto próbę pobrania danych z usuniętego wiersza.An attempt was made to retrieve data from a deleted row.

Podjęto próbę odczytu lub uzyskania dostępu do kolumny w zamkniętym DataTableReader.An attempt was made to read or access a column in a closed DataTableReader.

Przykłady

Podano DataTableReader i nazwę kolumny, procedura GetValueByName zwraca wartość określonej kolumny.Given a DataTableReader and a column name, the GetValueByName procedure returns the value of the specified column. Przed wywołaniem tej procedury należy utworzyć nowe wystąpienie DataTableReader i wywołać jego metodę odczytu co najmniej jeden raz, aby ustawić wskaźnik wiersza w wierszu danych.Before calling this procedure, you must create a new DataTableReader instance and call its Read method at least one time to position the row pointer on a row of data.

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

Uwagi

Wyszukiwanie z uwzględnieniem wielkości liter jest wykonywane jako pierwsze.A case-sensitive lookup is performed first. Jeśli to się nie powiedzie, zostanie wykonane drugie wyszukiwanie bez uwzględniania wielkości liter.If it fails, a second case-insensitive search is made.

Ta metoda jest niezależna od szerokości znaków kana.This method is kana-width insensitive.

Ta przeciążona wersja Item[String] jest zgodna z wywołaniem metody GetOrdinal, a następnie wywołanie metody GetValue.This overloaded version of Item[String] corresponds to calling the GetOrdinal method, and then subsequently calling the GetValue method.

Dotyczy