DataColumn.ColumnName Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Data

Zestaw:: System.Data.Common.dll

Zestaw:: System.Data.dll

Zestaw:: netstandard.dll

Źródło:: DataColumn.cs

Źródło:: DataColumn.cs

Źródło:: DataColumn.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia nazwę kolumny w elemecie 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

Wartość właściwości

String

Nazwa kolumny.

Atrybuty: DataSysDescriptionAttribute

Wyjątki

ArgumentException

Właściwość jest ustawiona na null wartość lub pusty ciąg, a kolumna należy do kolekcji.

DuplicateNameException

Kolumna o tej samej nazwie już istnieje w kolekcji. Porównanie nazw nie uwzględnia wielkości liter.

Przykłady

Poniższe przykłady pobiera wartość ColumnName dla każdej kolumny w każdej tabeli w elemecie DataSet. W przykładzie pokazano również, jak utworzyć element DataColumn z nowym ColumnNameelementem .

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

Uwagi

Po utworzeniu elementu DataColumn nie ColumnName ma wartości. Jednak po DataColumn dodaniu obiektu do DataColumnCollection DataTable obiektu zostanie podana nazwa domyślna ("Column1", "Column2" itd.).

Domyślnie Caption wartość jest ustawiona na ColumnName wartość .

Dotyczy

Produkt	Wersje
.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

Udostępnij za pośrednictwem