DataColumn.ColumnName 속성

정의

네임스페이스:

System.Data

어셈블리:

System.Data.Common.dll

Source:

DataColumn.cs

DataColumnCollection의 열 이름을 가져오거나 설정합니다.

public:
 property System::String ^ ColumnName { System::String ^ get(); void set(System::String ^ value); };

public string ColumnName { get; set; }

member this.ColumnName : string with get, set

Public Property ColumnName As String

속성 값

String

열 이름입니다.

예외

ArgumentException

속성이 null 또는 빈 문자열로 설정되어 있고 열이 컬렉션에 속한 경우

DuplicateNameException

이름이 같은 열이 컬렉션에 이미 있는 경우. 대/소문자를 구분하지 않고 이름을 비교합니다.

예제

다음 예제에서는 에 있는 모든 테이블의 모든 열에 대해 을 DataSet가져옵니다ColumnName. 이 예제에서는 새 ColumnName를 사용하여 을 DataColumn 만드는 방법도 보여 있습니다.

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

설명

가 DataColumn 만들어지면 값이 없습니다 ColumnName . 그러나 개체의 DataColumn 에 DataTable 가 추가 DataColumnCollection 되면 기본 이름("Column1", "Column2" 등)이 지정됩니다.

기본적으로 값은 Caption 값으로 설정됩니다 ColumnName .

추가 정보

• Caption
• ADO.NET에서 데이터 세트 사용