Condividi tramite


DataColumn.ColumnName Proprietà

Definizione

Ottiene o imposta il nome della colonna nell'insieme 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

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 .

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

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

Vedi anche