DataTableReader.Item[] Tulajdonság

Definíció

Névtér:

System.Data

Szerelvények:

netstandard.dll, System.Data.Common.dll

A megadott oszlop értékét a natív formátumában kapja meg.

Túlterhelések

Name	Description
Item[Int32]	A megadott oszlop értékét a natív formátumban kapja meg az oszlop sorszáma alapján.
Item[String]	Lekéri a megadott oszlop értékét natív formátumban az oszlopnév alapján.

Item[Int32]

Forrás:

DataTableReader.cs

A megadott oszlop értékét a natív formátumban kapja meg az oszlop sorszáma alapján.

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

Paraméterek

ordinal

Int32

A nulla alapú oszloprend.

Tulajdonság értéke

Object

A megadott oszlop értéke a natív formátumban.

Kivételek

IndexOutOfRangeException

Az átadott index a 0 FieldCount és 1 közötti tartományon kívül volt.

Példák

Az alábbi példa az összes oszlop tartalmát jeleníti meg a megadott DataTableReadersor összes sorában. A kód a Item[] metódust (az indexelőt Microsoft C#-ban) használja az egyes oszlopokban található érték lekéréséhez.

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

Megjegyzések

Ez a Item[] túlterhelés ugyanúgy viselkedik, mint a GetValue módszer.

Lásd még

• GetValue(Int32)

Item[String]

Forrás:

DataTableReader.cs

Lekéri a megadott oszlop értékét natív formátumban az oszlopnév alapján.

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

Paraméterek

name

String

Az oszlop neve.

Tulajdonság értéke

Object

A megadott oszlop értéke a natív formátumban.

Kivételek

ArgumentException

A megadott név nem érvényes oszlopnév.

DeletedRowInaccessibleException

Egy törölt sor adatainak lekérésére tett kísérlet történt.

InvalidOperationException

Egy bezárt DataTableReaderoszlop olvasására vagy elérésére tett kísérletet.

Példák

DataTableReader A GetValueByName eljárás a megadott oszlop értékét adja vissza. Az eljárás meghívása előtt létre kell hoznia egy új DataTableReader példányt, és legalább egyszer meg kell hívnia annak Olvasás metódusát, hogy a sormutatót egy adatsorra helyezze.

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

Megjegyzések

Először a kis- és nagybetűkre érzékeny keresés lesz végrehajtva. Ha nem sikerül, egy második kis- és nagybetűs keresés is létrejön.

Ez a módszer kana szélességű érzéketlen.

A túlterhelt verzió megfelel a metódus meghívásánakItem[], majd a metódus későbbi meghívásánakGetOrdinal.GetValue