DataTableReader.Item[] Properti

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

Mendapatkan nilai kolom yang ditentukan dalam format aslinya.

Overload

Item[Int32]	Mendapatkan nilai kolom yang ditentukan dalam format aslinya mengingat ordinal kolom.
Item[String]	Mendapatkan nilai kolom yang ditentukan dalam format aslinya dengan nama kolom.

Item[Int32]

Sumber:

DataTableReader.cs

Mendapatkan nilai kolom yang ditentukan dalam format aslinya mengingat ordinal kolom.

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

Ordinal kolom berbasis nol.

Nilai Properti

Object

Nilai kolom yang ditentukan dalam format aslinya.

Pengecualian

IndexOutOfRangeException

Indeks yang diteruskan berada di luar kisaran 0 hingga FieldCount - 1.

Contoh

Contoh berikut menampilkan konten semua kolom, di semua baris dari yang disediakan DataTableReader. Kode menggunakan Item[] metode (pengindeks, di Microsoft C#) untuk mengambil nilai yang terkandung dalam setiap kolom.

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

Keterangan

Kelebihan beban ini untuk Item[] ber perilaku identik dengan GetValue metode .

Lihat juga

• GetValue(Int32)

Item[String]

Sumber:

DataTableReader.cs

Mendapatkan nilai kolom yang ditentukan dalam format aslinya dengan nama kolom.

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

Nama kolom.

Nilai Properti

Object

Nilai kolom yang ditentukan dalam format aslinya.

Pengecualian

ArgumentException

Nama yang ditentukan bukan nama kolom yang valid.

DeletedRowInaccessibleException

Upaya dilakukan untuk mengambil data dari baris yang dihapus.

InvalidOperationException

Upaya dilakukan untuk membaca atau mengakses kolom dalam keadaan tertutup DataTableReader.

Contoh

DataTableReader Dengan nama kolom dan , prosedur GetValueByName mengembalikan nilai kolom yang ditentukan. Sebelum memanggil prosedur ini, Anda harus membuat instans baru DataTableReader dan memanggil metode Baca setidaknya satu kali untuk memposisikan penunjuk baris pada baris 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

Keterangan

Pencarian peka huruf besar/kecil dilakukan terlebih dahulu. Jika gagal, pencarian tidak peka huruf besar/kecil kedua akan dilakukan.

Metode ini tidak peka lebar kana.

Versi kelebihan beban Item[] ini sesuai dengan memanggil GetOrdinal metode , dan kemudian memanggil GetValue metode .