다음을 통해 공유


DataColumn 생성자

정의

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

오버로드

Name Description
DataColumn()

클래스의 새 인스턴스를 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
Source:
DataColumn.cs
Source:
DataColumn.cs

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

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

예제

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

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
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
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 되지 않았습니다.

예제

다음 예제에서는 지정된 ColumnNameDataType및 .을 사용하여 새로 DataColumn 만듭니다.

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
Source:
DataColumn.cs
Source:
DataColumn.cs

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

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")]
public DataColumn(string? columnName, Type dataType, string? expr);
public DataColumn(string? columnName, Type dataType, string? expr);
public DataColumn(string columnName, Type dataType, string expr);
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")>]
new System.Data.DataColumn : string * Type * string -> System.Data.DataColumn
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
Source:
DataColumn.cs
Source:
DataColumn.cs

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

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::String ^ expr, System::Data::MappingType type);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")]
public DataColumn(string? columnName, Type dataType, 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);
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types or types used in expressions may be trimmed if not referenced directly.")>]
new System.Data.DataColumn : string * Type * string * System.Data.MappingType -> System.Data.DataColumn
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 .

추가 정보

적용 대상