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

Определение

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

System.Data

Сборки:

netstandard.dll, 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, который содержится системой. 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