다음을 통해 공유


DataColumn 생성자

정의

DataColumn 클래스의 새 인스턴스를 초기화합니다.

오버로드

DataColumn()

클래스의 새 instance DataColumn 형식 문자열로 초기화합니다.

DataColumn(String)

지정된 열 이름을 사용하여 DataColumn 클래스의 새 인스턴스를 형식 문자열로 초기화합니다.

DataColumn(String, Type)

지정된 열 이름과 데이터 형식을 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.

DataColumn(String, Type, String)

지정된 이름, 데이터 형식 및 식을 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.

DataColumn(String, Type, String, MappingType)

열이 특성 열인지 여부를 결정하는 값, 지정된 이름, 데이터 형식 및 식을 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.

DataColumn()

Source:
DataColumn.cs
Source:
DataColumn.cs
Source:
DataColumn.cs

클래스의 새 instance DataColumn 형식 문자열로 초기화합니다.

public:
 DataColumn();
public DataColumn ();
Public Sub New ()

예제

다음 예제에서는 새 DataColumn를 만들고, 다양한 속성을 설정하고, 개체에 DataTable 대한 에 DataColumnCollection 추가합니다.

private void AddDataColumn(DataTable table)
{
    DataColumn column = new DataColumn();

    // Set various properties.
    column.ColumnName = "id";
    column.DataType = System.Type.GetType("System.Int32");
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}
Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As New DataColumn()

    ' Set various properties.
    With column
       .ColumnName = "id"
       .DataType = System.Type.GetType("System.Int32")
       .AutoIncrement = True
       .AutoIncrementSeed = 1
       .AutoIncrementStep = 1
       .ReadOnly = True
     End With

    ' Add to Columns collection.
    table.Columns.Add(column)
End Sub

설명

만들 때 개체에는 DataColumn 기본값 ColumnName 또는 Caption가 없습니다. 에 추가 DataColumnCollection하면 이름이 에 할당 ColumnName되지 않은 경우 기본 이름("Column1", "Column2" 등)이 생성됩니다.

추가 정보

적용 대상

DataColumn(String)

Source:
DataColumn.cs
Source:
DataColumn.cs
Source:
DataColumn.cs

지정된 열 이름을 사용하여 DataColumn 클래스의 새 인스턴스를 형식 문자열로 초기화합니다.

public:
 DataColumn(System::String ^ columnName);
public DataColumn (string? columnName);
public DataColumn (string columnName);
new System.Data.DataColumn : string -> System.Data.DataColumn
Public Sub New (columnName As String)

매개 변수

columnName
String

만들 열의 이름을 나타내는 문자열입니다. 이 속성 값이 null 또는 빈 문자열("")로 설정되면 열 컬렉션에 추가될 때 기본 이름이 지정됩니다.

예제

다음 예제에서는 지정된 ColumnName를 사용하여 새 DataColumn 를 만듭니다.

private void AddDataColumn(DataTable table)
{
    DataColumn column = new DataColumn("id");

    // Set various properties.
    column.DataType = System.Type.GetType("System.Int32");
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As DataColumn 
    column = New DataColumn("id")

    ' Set various properties.
    With column
       .DataType = System.Type.GetType("System.Int32")
       .AutoIncrement = True
       .AutoIncrementSeed = 1
       .AutoIncrementStep = 1
       .ReadOnly = True
     End With

    ' Add to Columns collection.
    table.Columns.Add(column)
End Sub

설명

기본적으로 열과 관련된 이름은 속성 값이 Caption 됩니다.

추가 정보

적용 대상

DataColumn(String, Type)

Source:
DataColumn.cs
Source:
DataColumn.cs
Source:
DataColumn.cs

지정된 열 이름과 데이터 형식을 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType);
public DataColumn (string? columnName, Type dataType);
public DataColumn (string columnName, Type dataType);
new System.Data.DataColumn : string * Type -> System.Data.DataColumn
Public Sub New (columnName As String, dataType As Type)

매개 변수

columnName
String

만들 열의 이름을 나타내는 문자열입니다. 이 속성 값이 null 또는 빈 문자열("")로 설정되면 열 컬렉션에 추가될 때 기본 이름이 지정됩니다.

dataType
Type

지원되는 DataType입니다.

예외

dataType이 지정되지 않은 경우

예제

다음 예제에서는 지정된 및 DataType를 사용하여 새 DataColumnColumnName 만듭니다.

private void AddDataColumn(DataTable table)
{
    System.Type typeInt32 =
        System.Type.GetType("System.Int32");
    DataColumn column = new DataColumn("id", typeInt32);

    // Set various properties.
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1;
    column.AutoIncrementStep = 1;
    column.ReadOnly = true;

    // Add to Columns collection.
    table.Columns.Add(column);
}

Private Sub AddDataColumn(ByVal table As DataTable)
    
   Dim typeInt32 As System.Type = _
      System.Type.GetType("System.Int32")
   Dim column As DataColumn = _
       New DataColumn("id", typeInt32)

   ' Set various properties.
   With column
      .AutoIncrement = True
      .AutoIncrementSeed = 1
      .AutoIncrementStep = 1
      .ReadOnly = True
    End With

   ' Add to Columns collection.
   table.Columns.Add(column)
End Sub

추가 정보

적용 대상

DataColumn(String, Type, String)

Source:
DataColumn.cs
Source:
DataColumn.cs
Source:
DataColumn.cs

지정된 이름, 데이터 형식 및 식을 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr);
public DataColumn (string? columnName, Type dataType, string? expr);
public DataColumn (string columnName, Type dataType, string expr);
new System.Data.DataColumn : string * Type * string -> System.Data.DataColumn
Public Sub New (columnName As String, dataType As Type, expr As String)

매개 변수

columnName
String

만들 열의 이름을 나타내는 문자열입니다. 이 속성 값이 null 또는 빈 문자열("")로 설정되면 열 컬렉션에 추가될 때 기본 이름이 지정됩니다.

dataType
Type

지원되는 DataType입니다.

expr
String

이 열을 만드는 데 사용되는 식입니다. 자세한 내용은 Expression 속성을 참조하세요.

예외

dataType이 지정되지 않은 경우

예제

다음 예제에서는 계산 열을 만듭니다.

private void AddDataColumn(DataTable table)
{
    System.Type decimalType;
    decimalType = System.Type.GetType("System.Decimal");

    // Create the column. The name is 'Tax,' with data type Decimal,and
    // an expression ('UnitPrice * .0862) to calculate the tax.
    DataColumn column = new DataColumn("Tax",
        decimalType, "UnitPrice * .0862");

    // Set various properties.
    column.AutoIncrement = false;
    column.ReadOnly = true;

    // Add to Columns collection.;
    table.Columns.Add(column);
}
Private Sub AddDataColumn(ByVal table As DataTable)
    Dim column As DataColumn 
    Dim decimalType As System.Type
 
    decimalType = System.Type.GetType("System.Decimal")
    column = New DataColumn("Tax", decimalType, "UnitPrice * .0862")

    ' Set various properties.
    With column
       .AutoIncrement = False
       .ReadOnly = True
    End With

    ' Add to Columns collection.
    table.Columns.Add(column)
 End Sub

추가 정보

적용 대상

DataColumn(String, Type, String, MappingType)

Source:
DataColumn.cs
Source:
DataColumn.cs
Source:
DataColumn.cs

열이 특성 열인지 여부를 결정하는 값, 지정된 이름, 데이터 형식 및 식을 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr, System::Data::MappingType type);
public DataColumn (string? columnName, Type dataType, string? expr, System.Data.MappingType type);
public DataColumn (string columnName, Type dataType, string expr, System.Data.MappingType type);
new System.Data.DataColumn : string * Type * string * System.Data.MappingType -> System.Data.DataColumn
Public Sub New (columnName As String, dataType As Type, expr As String, type As MappingType)

매개 변수

columnName
String

만들 열의 이름을 나타내는 문자열입니다. 이 속성 값이 null 또는 빈 문자열("")로 설정되면 열 컬렉션에 추가될 때 기본 이름이 지정됩니다.

dataType
Type

지원되는 DataType입니다.

expr
String

이 열을 만드는 데 사용되는 식입니다. 자세한 내용은 Expression 속성을 참조하세요.

type
MappingType

MappingType 값 중 하나입니다.

예외

dataType이 지정되지 않은 경우

예제

다음 예제에서는 계산 열을 생성합니다.

private void CreateComputedColumn(DataTable table)
{
    System.Type myDataType =
        System.Type.GetType("System.Decimal");

    // The expression multiplies the "Price" column value
    // by the "Quantity" to create the "Total" column.
    string expression = "Price * Quantity";

    // Create the column, setting the type to Attribute.
    DataColumn column = new DataColumn("Total", myDataType,
        expression, MappingType.Attribute);

    // Set various properties.
    column.AutoIncrement = false;
    column.ReadOnly = true;

    // Add the column to a DataTable object's to DataColumnCollection.
    DataSet1.Tables["OrderDetails"].Columns.Add(column);
}
Private Sub CreateComputedColumn(ByVal table As DataTable)
    Dim column As DataColumn
    Dim decimalType As System.Type = _
        System.Type.GetType("System.Decimal")

    ' The expression multiplies the "Price" column value by the 
    ' "Quantity" to create the "Total" column.
    Dim expression As String = "Price * Quantity"

    ' Create the column, setting the type to Attribute.
    column = New DataColumn("Total", decimalType, _
        expression, MappingType.Attribute)

    ' Set various properties.
    column.AutoIncrement = False
    column.ReadOnly = True

    ' Add the column to a DataTable object's DataColumnCollection.
    DataSet1.Tables("OrderDetails").Columns.Add(column)
End Sub

설명

인수는 type 속성을 설정합니다 ColumnMapping . 속성은 가 XML 문서로 변환될 때 를 DataSet 매핑하는 방법을 DataColumn 지정합니다. 예를 들어 열 이름이 "fName"이고 열에 포함된 값이 "Bob"이고 type 로 설정된 MappingType.Attribute경우 XML 요소는 다음과 같습니다.

<이름 fName = 'Bob'/>

열이 요소 또는 특성에 매핑되는 방법에 대한 자세한 내용은 속성을 참조 ColumnMapping 하세요.

추가 정보

적용 대상