DataColumnCollection.Item[] Propriedade

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Obtém o DataColumn especificado da coleção.

Sobrecargas

Item[Int32]	Obtém o DataColumn da coleção no índice especificado.
Item[String]	Obtém o DataColumn da coleção com o nome especificado.

Item[Int32]

Origem:

DataColumnCollection.cs

Obtém o DataColumn da coleção no índice especificado.

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

Parâmetros

index

Int32

O índice baseado em zero da coluna a ser retornada.

Valor da propriedade

DataColumn

O DataColumn no índice especificado.

Exceções

IndexOutOfRangeException

O valor de índice é maior que o número de itens na coleção.

Exemplos

O exemplo a seguir usa a Item[] propriedade para imprimir o ColumnName valor de um DataColumn objeto especificado pelo índice. O exemplo usa o DataTable contido por um System.Windows.Forms. Controle 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

Comentários

O Contains método pode ser usado para testar a existência de uma coluna. Isso é útil antes de tentar usar Item[].

Confira também

• ColumnName
• Contains(String)
• DataColumn

Item[String]

Origem:

DataColumnCollection.cs

Obtém o DataColumn da coleção com o nome especificado.

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

Parâmetros

name

String

O ColumnName da coleção a ser retornado.

Valor da propriedade

DataColumn

O DataColumn na coleção com o ColumnName especificado; caso contrário, um valor nulo se o DataColumn não existir.

Exemplos

O exemplo a seguir usa a Item[] propriedade para imprimir o DataType valor de um DataColumn objeto especificado pelo índice.

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

Comentários

Item[] diferencia maiúsculas de minúsculas condicionalmente quando pesquisa nomes de coluna. Por exemplo, se um DataColumn for chamado de "mydatacolumn" e outro for chamado de "Mydatacolumn", uma cadeia de caracteres usada para pesquisar uma das colunas será considerada que diferencia maiúsculas de minúsculas. No entanto, se "mydatacolumn" existir e "Mydatacolumn" não existir, a cadeia de caracteres de pesquisa será considerada que não diferencia maiúsculas de minúsculas.

Confira também

• ColumnName
• Contains(String)
• DataColumn