DataTableReader.Item[] Özellik

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.Common.dll

Belirtilen sütunun değerini yerel biçiminde alır.

Aşırı Yüklemeler

Item[Int32]	Belirtilen sütunun değerini, sütun sırasıyla verilen yerel biçiminde alır.
Item[String]	Belirtilen sütunun değerini, sütun adı verilen yerel biçiminde alır.

Item[Int32]

Kaynak:

DataTableReader.cs

Belirtilen sütunun değerini, sütun sırasıyla verilen yerel biçiminde alır.

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

Parametreler

ordinal

Int32

Sıfır tabanlı sütun sıralı.

Özellik Değeri

Object

Belirtilen sütunun yerel biçimindeki değeri.

Özel durumlar

IndexOutOfRangeException

Geçirilen dizin 0 FieldCount - 1 aralığının dışındaydı.

Örnekler

Aşağıdaki örnek, sağlanan DataTableReaderiçindeki tüm satırlarda tüm sütunların içeriğini görüntüler. Kod, her sütunda yer alan değeri almak için yöntemini (Microsoft C#'de dizin oluşturucu) kullanır Item[] .

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

Açıklamalar

için Item[] bu aşırı yükleme yöntemiyle GetValue aynı şekilde davranır.

Ayrıca bkz.

• GetValue(Int32)

Item[String]

Kaynak:

DataTableReader.cs

Belirtilen sütunun değerini, sütun adı verilen yerel biçiminde alır.

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

Parametreler

name

String

Sütunun adı.

Özellik Değeri

Object

Belirtilen sütunun yerel biçimindeki değeri.

Özel durumlar

ArgumentException

Belirtilen ad geçerli bir sütun adı değil.

DeletedRowInaccessibleException

Silinen bir satırdan veri alma girişiminde bulunuldu.

InvalidOperationException

Kapalı bir içindeki bir sütunu okuma veya sütuna erişme girişiminde bulunuldu DataTableReader.

Örnekler

Bir DataTableReader ve sütun adı verüldüğünde, GetValueByName yordamı belirtilen sütunun değerini döndürür. Bu yordamı çağırmadan önce yeni DataTableReader bir örnek oluşturmanız ve satır işaretçisini bir veri satırına konumlandırmak için read yöntemini en az bir kez çağırmanız gerekir.

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

Açıklamalar

Önce büyük/küçük harfe duyarlı arama gerçekleştirilir. Başarısız olursa ikinci bir büyük/küçük harfe duyarsız arama yapılır.

Bu yöntem kana-width duyarsızdır.

Bu aşırı yüklenmiş sürümü Item[] yöntemini çağırmaya GetOrdinal ve ardından yöntemini çağırmaya GetValue karşılık gelir.