DataColumnCollection.Item[] Właściwość

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

Pobiera określony DataColumn element z kolekcji.

Przeciążenia

Item[Int32]	Pobiera element DataColumn z kolekcji w określonym indeksie.
Item[String]	Pobiera element DataColumn z kolekcji o określonej nazwie.

Item[Int32]

Źródło:

DataColumnCollection.cs

Pobiera element DataColumn z kolekcji w określonym indeksie.

public:
 property System::Data::DataColumn ^ default[int] { System::Data::DataColumn ^ get(int index); };

public System.Data.DataColumn this[int index] { get; }

member this.Item(int) : System.Data.DataColumn

Default Public ReadOnly Property Item(index As Integer) As DataColumn

Parametry

index

Int32

Indeks oparty na zerowej kolumnie do zwrócenia.

Wartość właściwości

DataColumn

Element DataColumn w określonym indeksie.

Wyjątki

IndexOutOfRangeException

Wartość indeksu jest większa niż liczba elementów w kolekcji.

Przykłady

W poniższym przykładzie użyto Item[] właściwości do wydrukowania ColumnName wartości obiektu określonego DataColumn przez indeks. W przykładzie użyto elementu DataTable zawartego w pliku System.Windows.Forms. Kontrolka DataGrid.

private void PrintColumnNamesByIndex(DataTable table)
{
    // Get the DataColumnCollection from a DataTable in a DataSet.
    DataColumnCollection columns = table.Columns;

    // Print each column's name using the Index.
    for (int i = 0 ;i <columns.Count ;i++)
        Console.WriteLine(columns[i]);
}

Private Sub PrintColumnNamesByIndex(table As DataTable)
    ' Get the DataColumnCollection from a DataTable in a DataSet.
    Dim columns As DataColumnCollection = table.Columns

    ' Print each column's name using the Index.
    Dim i As Integer
    For i = 0 To columns.Count - 1
        Console.WriteLine(columns(i))
    Next i
End Sub

Uwagi

Metoda Contains może służyć do testowania istnienia kolumny. Jest to przydatne przed próbą użycia polecenia Item[].

Zobacz też

• ColumnName
• Contains(String)
• DataColumn

Item[String]

Źródło:

DataColumnCollection.cs

Pobiera element DataColumn z kolekcji o określonej nazwie.

public:
 property System::Data::DataColumn ^ default[System::String ^] { System::Data::DataColumn ^ get(System::String ^ name); };

public System.Data.DataColumn? this[string name] { get; }

member this.Item(string) : System.Data.DataColumn

Default Public ReadOnly Property Item(name As String) As DataColumn

Parametry

name

String

Kolumna ColumnName do zwrócenia.

Wartość właściwości

DataColumn

Element DataColumn w kolekcji o określonej wartości ColumnName; w przeciwnym razie wartość null, jeśli DataColumn nie istnieje.

Przykłady

W poniższym przykładzie użyto Item[] właściwości do wydrukowania DataType wartości obiektu określonego DataColumn przez indeks.

private void PrintDataType(DataTable table)
{
    // Get the DataColumnCollection from a DataTable in a DataSet.
    DataColumnCollection columns = table.Columns;

    // Print the column's data type.
    Console.WriteLine(columns["id"].DataType);
}

Private Sub PrintDataType(table As DataTable)
     ' Get the DataColumnCollection from a DataTable in a DataSet.
     Dim columns As DataColumnCollection = table.Columns

     ' Print the column's data type.
     Console.WriteLine(columns("id").DataType)
End Sub

Uwagi

Item[] jest warunkowo uwzględniana wielkość liter, gdy wyszukuje nazwy kolumn. Jeśli na przykład DataColumn nazwa ma nazwę "mydatacolumn", a druga nosi nazwę "Mydatacolumn", ciąg używany do wyszukiwania jednej z kolumn jest traktowany jako rozróżniana wielkość liter. Jeśli jednak ciąg wyszukiwania "mydatacolumn" istnieje i "Mydatacolumn" nie, ciąg wyszukiwania jest uważany za bez uwzględniania wielkości liter.

Zobacz też

• ColumnName
• Contains(String)
• DataColumn