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

Определение

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

Перегрузки

Item[Int32]

Получает объект DataColumn из коллекции по указанному индексу.Gets the DataColumn from the collection at the specified index.

Item[String]

Получает объект DataColumn из коллекции с указанным именем.Gets the DataColumn from the collection with the specified name.

Item[Int32]

Получает объект DataColumn из коллекции по указанному индексу.Gets the DataColumn from the collection at the specified index.

public:
 property System::Data::DataColumn ^ default[int] { System::Data::DataColumn ^ get(int index); };
public:
 virtual property System::Data::DataColumn ^ default[int] { System::Data::DataColumn ^ get(int index); };
public System.Data.DataColumn this[int index] { get; }
public virtual System.Data.DataColumn this[int index] { get; }
member this.Item(int) : System.Data.DataColumn
Default Public ReadOnly Property Item(index As Integer) As DataColumn
Default Public Overridable ReadOnly Property Item(index As Integer) As DataColumn

Параметры

index
Int32

Индекс (с нуля) возвращаемого столбца.The zero-based index of the column to return.

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

DataColumn

Объект DataColumn по указанному индексу.The DataColumn at the specified index.

Исключения

Значение индекса больше числа элементов в коллекции.The index value is greater than the number of items in the collection.

Примеры

В следующем примере свойство используется Item[] для вывода ColumnName значения DataColumn объекта, указанного в параметре index.The following example uses the Item[] property to print the ColumnName value of a DataColumn object specified by index. В примере используется объект DataTable , содержащийся в элементе управления System. Windows. Forms. DataGrid.The example uses the DataTable that is contained by a System.Windows.Forms.DataGrid control.

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Метод можно использовать для проверки существования столбца.The Contains method can be used to test for the existence of a column. Это полезно, прежде чем пытаться использовать Item[] .This is useful before you try to use Item[].

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

Применяется к

Item[String]

Получает объект DataColumn из коллекции с указанным именем.Gets the DataColumn from the collection with the specified name.

public:
 property System::Data::DataColumn ^ default[System::String ^] { System::Data::DataColumn ^ get(System::String ^ name); };
public:
 virtual property System::Data::DataColumn ^ default[System::String ^] { System::Data::DataColumn ^ get(System::String ^ name); };
public System.Data.DataColumn? this[string name] { get; }
public System.Data.DataColumn this[string name] { get; }
public virtual System.Data.DataColumn this[string name] { get; }
member this.Item(string) : System.Data.DataColumn
Default Public ReadOnly Property Item(name As String) As DataColumn
Default Public Overridable ReadOnly Property Item(name As String) As DataColumn

Параметры

name
String

Свойство ColumnName возвращаемого столбца.The ColumnName of the column to return.

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

DataColumn

Объект DataColumn в коллекции с указанным значением свойства ColumnName; в противном случае — значение null, если DataColumn не существует.The DataColumn in the collection with the specified ColumnName; otherwise a null value if the DataColumn does not exist.

Примеры

В следующем примере свойство используется Item[] для вывода DataType значения DataColumn объекта, указанного в параметре index.The following example uses the Item[] property to print the DataType value of a DataColumn object specified by index.

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[] при поиске имен столбцов регистр учитывается в условном регистре.Item[] is conditionally case-sensitive when it searches for column names. Например, если один DataColumn из них имеет имя «мидатаколумн», а другой — «мидатаколумн», то строка, используемая для поиска одного из столбцов, считается с учетом регистра.For example, if one DataColumn is named "mydatacolumn" and another is named "Mydatacolumn", a string used to search for one of the columns is regarded as case-sensitive. Однако если "мидатаколумн" существует, а "Мидатаколумн" — нет, то строка поиска считается без учета регистра.However, if "mydatacolumn" exists and "Mydatacolumn" does not, the search string is regarded as case-insensitive.

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

Применяется к