DataColumn.ColumnName Propriedade
Definição
Obtém ou define o nome da coluna no DataColumnCollection.Gets or sets the name of the column in the DataColumnCollection.
public:
property System::String ^ ColumnName { System::String ^ get(); void set(System::String ^ value); };
public string ColumnName { get; set; }
[System.Data.DataSysDescription("DataColumnColumnNameDescr")]
public string ColumnName { get; set; }
member this.ColumnName : string with get, set
[<System.Data.DataSysDescription("DataColumnColumnNameDescr")>]
member this.ColumnName : string with get, set
Public Property ColumnName As String
Valor da propriedade
O nome da coluna.The name of the column.
- Atributos
Exceções
A propriedade é definida como null ou com uma cadeia de caracteres vazia e a coluna pertence a uma coleção.The property is set to null or an empty string and the column belongs to a collection.
Uma coluna com o mesmo nome já existe na coleção.A column with the same name already exists in the collection. A comparação de nomes não diferencia maiúsculas de minúsculas.The name comparison is not case sensitive.
Exemplos
Os exemplos a seguir obtém o ColumnName para cada coluna em cada tabela em um DataSet .The following examples gets the ColumnName for every column in every table in a DataSet. O exemplo também mostra como criar um DataColumn com um novo ColumnName .The example also shows how to create a DataColumn with a new ColumnName.
private void PrintColumnNames(DataSet dataSet)
{
// For each DataTable, print the ColumnName.
foreach(DataTable table in dataSet.Tables)
{
foreach(DataColumn column in table.Columns)
{
Console.WriteLine(column.ColumnName);
}
}
}
private void AddColumn(DataTable table)
{
DataColumn column;
column = new DataColumn();
column.ColumnName = "SupplierID";
column.DataType = System.Type.GetType("System.String");
column.Unique = true;
column.AutoIncrement = false;
column.Caption = "SupplierID";
column.ReadOnly = false;
// Add the column to the table's columns collection.
table.Columns.Add(column);
}
Private Sub PrintColumnNames(dataSet As DataSet)
Dim table As DataTable
Dim column As DataColumn
' For each DataTable, print the ColumnName.
For Each table in dataSet.Tables
For Each column in table.Columns
Console.WriteLine(column.ColumnName)
Next
Next
End Sub
Private Sub AddColumn(table As DataTable)
Dim column As DataColumn
column = New DataColumn()
With column
.ColumnName = "SupplierID"
.DataType = System.Type.GetType("System.String")
.Unique = True
.AutoIncrement = False
.Caption = "SupplierID"
.ReadOnly = False
End With
' Add the column to the table's columns collection.
table.Columns.Add(column)
End Sub
Comentários
Quando um DataColumn é criado, ele não tem ColumnName valor.When a DataColumn is created, it has no ColumnName value. No entanto, quando o DataColumn é adicionado a um DataColumnCollection para um DataTable objeto, ele recebe um nome padrão ("Coluna1", "Coluna2" e assim por diante).However, when the DataColumn is added to a DataColumnCollection for a DataTable object, it is given a default name ("Column1", "Column2", and so on).
Por padrão, o Caption valor é definido como o ColumnName valor.By default, the Caption value is set to the ColumnName value.