DataColumn.ColumnName 속성


DataColumnCollection의 열 이름을 가져오거나 설정합니다.Gets or sets the name of the column in the DataColumnCollection.

 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

속성 값

열 이름입니다.The name of the column.



속성이 null 또는 빈 문자열로 설정되어 있고 열이 컬렉션에 속한 경우The property is set to null or an empty string and the column belongs to a collection.

이름이 같은 열이 컬렉션에 이미 있는 경우.A column with the same name already exists in the collection. 대/소문자를 구분하지 않고 이름을 비교합니다.The name comparison is not case sensitive.


다음 예제에서는 가져옵니다 합니다 ColumnName 모든 테이블에 있는 모든 열에 대 한는 DataSet합니다.The following examples gets the ColumnName for every column in every table in a DataSet. 또한이 예에서는 만드는 방법을 DataColumnColumnName합니다.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)

   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.
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
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.
End Sub


경우는 DataColumn 은 no가 만들어지면 ColumnName 값입니다.When a DataColumn is created, it has no ColumnName value. 그러나 경우는 DataColumn 에 추가 됩니다을 DataColumnCollection 에 대 한는 DataTable 개체 ("Column1", "Column2" 등)는 기본 이름이 지정 되 고 합니다.However, when the DataColumn is added to a DataColumnCollection for a DataTable object, it is given a default name ("Column1", "Column2", and so on).

기본적으로 Caption 값으로 설정 됩니다는 ColumnName 값입니다.By default, the Caption value is set to the ColumnName value.

적용 대상

추가 정보