DataColumn 생성자

정의

DataColumn 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DataColumn class.

오버로드

DataColumn()

DataColumn 클래스의 새 인스턴스를 형식 문자열로 초기화합니다.Initializes a new instance of a DataColumn class as type string.

DataColumn(String)

지정된 열 이름을 사용하여 DataColumn 클래스의 새 인스턴스를 형식 문자열로 초기화합니다.Initializes a new instance of the DataColumn class, as type string, using the specified column name.

DataColumn(String, Type)

지정된 열 이름과 데이터 형식을 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DataColumn class using the specified column name and data type.

DataColumn(String, Type, String)

지정된 이름, 데이터 형식 및 식을 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DataColumn class using the specified name, data type, and expression.

DataColumn(String, Type, String, MappingType)

열이 특성 열인지 여부를 결정하는 값, 지정된 이름, 데이터 형식 및 식을 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DataColumn class using the specified name, data type, expression, and value that determines whether the column is an attribute.

DataColumn()

DataColumn 클래스의 새 인스턴스를 형식 문자열로 초기화합니다.Initializes a new instance of a DataColumn class as type string.

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

예제

다음 예에서는 새 DataColumn만들고, 다양 한 속성을 설정 하 고, DataTable 개체의 DataColumnCollection에 추가 합니다.The following example creates a new DataColumn, sets various properties, and adds it to a DataColumnCollection for the DataTable object.

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없습니다.When created, a DataColumn object has no default ColumnName or Caption. DataColumnCollection에 추가 하면 ColumnName에 이름이 할당 되지 않은 경우 기본 이름 ("Column1", "Column2" 등)이 생성 됩니다.When you add it to a DataColumnCollection, a default name ("Column1", "Column2", and so on) will be generated if a name has not been assigned to the ColumnName.

추가 정보

DataColumn(String)

지정된 열 이름을 사용하여 DataColumn 클래스의 새 인스턴스를 형식 문자열로 초기화합니다.Initializes a new instance of the DataColumn class, as type string, using the specified column name.

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

매개 변수

columnName
String

만들 열의 이름을 나타내는 문자열입니다.A string that represents the name of the column to be created. 이 속성 값이 null 또는 빈 문자열("")로 설정되면 열 컬렉션에 추가될 때 기본 이름이 지정됩니다.If set to null or an empty string (""), a default name will be specified when added to the columns collection.

예제

다음 예에서는 지정 된 ColumnName를 사용 하 여 새 DataColumn을 만듭니다.The following example creates a new DataColumn with a specified ColumnName.

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 속성 값이 됩니다.By default, the name specific to a column becomes the Caption property value.

추가 정보

DataColumn(String, Type)

지정된 열 이름과 데이터 형식을 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DataColumn class using the specified column name and data type.

public:
 DataColumn(System::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

만들 열의 이름을 나타내는 문자열입니다.A string that represents the name of the column to be created. 이 속성 값이 null 또는 빈 문자열("")로 설정되면 열 컬렉션에 추가될 때 기본 이름이 지정됩니다.If set to null or an empty string (""), a default name will be specified when added to the columns collection.

dataType
Type

지원되는 DataType입니다.A supported DataType.

예외

dataType이 지정되지 않은 경우No dataType was specified.

예제

다음 예에서는 지정 된 ColumnNameDataType를 사용 하 여 새 DataColumn을 만듭니다.The following example creates a new DataColumn with a specified ColumnName and DataType.

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)

지정된 이름, 데이터 형식 및 식을 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DataColumn class using the specified name, data type, and expression.

public:
 DataColumn(System::String ^ columnName, Type ^ dataType, System::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

만들 열의 이름을 나타내는 문자열입니다.A string that represents the name of the column to be created. 이 속성 값이 null 또는 빈 문자열("")로 설정되면 열 컬렉션에 추가될 때 기본 이름이 지정됩니다.If set to null or an empty string (""), a default name will be specified when added to the columns collection.

dataType
Type

지원되는 DataType입니다.A supported DataType.

expr
String

이 열을 만드는 데 사용되는 식입니다.The expression used to create this column. 자세한 내용은 Expression 속성을 참조하세요.For more information, see the Expression property.

예외

dataType이 지정되지 않은 경우No dataType was specified.

예제

다음 예제에서는 계산된 열을 만듭니다.The following example creates a computed column.

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)

열이 특성 열인지 여부를 결정하는 값, 지정된 이름, 데이터 형식 및 식을 사용하여 DataColumn 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DataColumn class using the specified name, data type, expression, and value that determines whether the column is an attribute.

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

만들 열의 이름을 나타내는 문자열입니다.A string that represents the name of the column to be created. 이 속성 값이 null 또는 빈 문자열("")로 설정되면 열 컬렉션에 추가될 때 기본 이름이 지정됩니다.If set to null or an empty string (""), a default name will be specified when added to the columns collection.

dataType
Type

지원되는 DataType입니다.A supported DataType.

expr
String

이 열을 만드는 데 사용되는 식입니다.The expression used to create this column. 자세한 내용은 Expression 속성을 참조하세요.For more information, see the Expression property.

type
MappingType

MappingType 값 중 하나입니다.One of the MappingType values.

예외

dataType이 지정되지 않은 경우No dataType was specified.

예제

다음 예제에서는 계산된 열을 생성합니다.The following example constructs a computed column.

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 속성을 설정 합니다.The type argument sets the ColumnMapping property. 속성은 DataSet XML 문서로 변환 될 때 DataColumn 매핑되는 방법을 지정 합니다.The property specifies how a DataColumn is mapped when a DataSet is transformed into an XML document. 예를 들어 열 이름이 "fName"이 고 포함 된 값이 "Bob"이 고 typeMappingType.Attribute으로 설정 된 경우 XML 요소는 다음과 같습니다.For example, if the column is named "fName," and the value it contains is "Bob," and type is set to MappingType.Attribute, the XML element would be as follows:

<이름 fName = ' Bob '/><Name fName = 'Bob'/>

열이 요소 또는 특성에 매핑되는 방법에 대 한 자세한 내용은 ColumnMapping 속성을 참조 하세요.For more information about how columns are mapped to elements or attributes, see the ColumnMapping property.

추가 정보

적용 대상