DataColumn.ColumnName 속성

아티클
08/21/2007

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

네임스페이스: System.Data
어셈블리: System.Data(system.data.dll)

구문

‘선언
Public Property ColumnName As String
‘사용 방법
Dim instance As DataColumn
Dim value As String

value = instance.ColumnName

instance.ColumnName = value

public string ColumnName { get; set; }

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

/** @property */
public String get_ColumnName ()

/** @property */
public void set_ColumnName (String value)

public function get ColumnName () : String

public function set ColumnName (value : String)

속성 값

열의 이름입니다.

예외

예외 형식	조건
ArgumentException	속성이 Null 참조(Visual Basic의 경우 Nothing) 또는 빈 문자열로 설정되어 있고 열이 컬렉션에 속한 경우
DuplicateNameException	이름이 같은 열이 컬렉션에 이미 있는 경우. 대/소문자를 구분하지 않고 이름을 비교합니다.

설명

DataColumn을 만들 때는 해당 열에 ColumnName 값이 없지만, 그러나 DataColumn을 DataTable 개체의 DataColumnCollection에 추가하면 "Column1", "Column2" 등의 기본 이름이 지정됩니다.

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

예제

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

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

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

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

DataColumn 클래스
DataColumn 멤버
System.Data 네임스페이스
DataColumn.Caption 속성

다음을 통해 공유