DataColumnCollection.Item[] Свойство

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Возвращает указанный объект DataColumn из коллекции.

Перегрузки

Item[Int32]	Получает объект DataColumn из коллекции по указанному индексу.
Item[String]	Получает объект DataColumn из коллекции с указанным именем.

Item[Int32]

Исходный код:

DataColumnCollection.cs

Получает объект DataColumn из коллекции по указанному индексу.

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

Параметры

index

Int32

Индекс (с нуля) возвращаемого столбца.

Значение свойства

DataColumn

Объект DataColumn по указанному индексу.

Исключения

IndexOutOfRangeException

Значение индекса больше числа элементов в коллекции.

Примеры

В следующем примере свойство используется для Item[] вывода ColumnName значения объекта, DataColumn заданного индексом. В примере используется DataTable объект , содержащийся в System.Windows.Forms. Элемент управления 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

Комментарии

Метод Contains можно использовать для проверки наличия столбца. Это полезно перед попыткой использования Item[].

См. также раздел

• ColumnName
• Contains(String)
• DataColumn

Item[String]

Исходный код:

DataColumnCollection.cs

Получает объект DataColumn из коллекции с указанным именем.

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

Параметры

name

String

Свойство ColumnName возвращаемого столбца.

Значение свойства

DataColumn

Объект DataColumn в коллекции с указанным значением свойства ColumnName; в противном случае — значение null, если DataColumn не существует.

Примеры

В следующем примере свойство используется для Item[] вывода DataType значения объекта, DataColumn заданного индексом.

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

Комментарии

Item[] Параметр условно учитывает регистр при поиске имен столбцов. Например, если один из них DataColumn называется mydatacolumn, а другой — Mydatacolumn, строка, используемая для поиска одного из столбцов, считается с учетом регистра. Однако если "mydatacolumn" существует, а "Mydatacolumn" — нет, строка поиска считается без учета регистра.

См. также раздел

• ColumnName
• Contains(String)
• DataColumn