DataColumn.ColumnName Proprietà

Definizione

Ottiene o imposta il nome della colonna nell'insieme DataColumnCollection.

C#
public string ColumnName { get; set; }
C#
[System.Data.DataSysDescription("DataColumnColumnNameDescr")]
public string ColumnName { get; set; }

Valore della proprietà

Nome della colonna.

Attributi

Eccezioni

La proprietà è impostata su null o su una stringa vuota e la colonna appartiene a un insieme.

Nell'insieme è già presente una colonna con lo stesso nome. Nel confronto tra nomi non viene applicata la distinzione tra maiuscole e minuscole.

Esempio

Gli esempi seguenti ottengono l'oggetto ColumnName per ogni colonna di ogni tabella in un DataSetoggetto . L'esempio illustra anche come creare un DataColumn oggetto con un nuovo ColumnNameoggetto .

C#
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);
}

Commenti

Quando viene creato un oggetto DataColumn , non ColumnName ha alcun valore. Tuttavia, quando l'oggetto DataColumn viene aggiunto a un DataColumnCollection oggetto DataTable , viene assegnato un nome predefinito ("Column1", "Column2" e così via).

Per impostazione predefinita, il Caption valore è impostato sul ColumnName valore.

Si applica a

Prodotto Versioni
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Vedi anche