DataColumn 생성자

참조

정의

네임스페이스:: System.Data

어셈블리:: System.Data.Common.dll

어셈블리:: System.Data.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

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입니다.

예외

ArgumentNullException

dataType이 지정되지 않은 경우

예제

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

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 속성을 참조하세요.

예외

ArgumentNullException

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 값 중 하나입니다.

예외

ArgumentNullException

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 하세요.

추가 정보

적용 대상

DataColumn 생성자

정의

오버로드

DataColumn()

예제

설명

추가 정보

적용 대상

DataColumn(String)

매개 변수

예제

설명

추가 정보

적용 대상

DataColumn(String, Type)

매개 변수

예외

예제

추가 정보

적용 대상

DataColumn(String, Type, String)

매개 변수

예외

예제

추가 정보

적용 대상

DataColumn(String, Type, String, MappingType)

매개 변수

예외

예제

설명

추가 정보

적용 대상

피드백

추가 리소스