DataColumn コンストラクター

定義

DataColumn クラスの新しいインスタンスを初期化します。

オーバーロード

DataColumn()

クラスの新しいインスタンスを DataColumn 型文字列として初期化します。

DataColumn(String)

指定した列名を使用して、DataColumn クラスの新しいインスタンスを文字列型として初期化します。

DataColumn(String, Type)

指定した列名とデータ型を使用して DataColumn クラスの新しいインスタンスを初期化します。

DataColumn(String, Type, String)

指定した名前、データ型、および式を使用して DataColumn クラスの新しいインスタンスを初期化します。

DataColumn(String, Type, String, MappingType)

指定した名前、データ型、式、およびこの列が属性かどうかを決定する値を使用して、DataColumn クラスの新しいインスタンスを初期化します。

DataColumn()

ソース:
DataColumn.cs
ソース:
DataColumn.cs
ソース:
DataColumn.cs

クラスの新しいインスタンスを DataColumn 型文字列として初期化します。

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

次の例では、新DataColumnしい を作成し、さまざまなプロパティを設定し、 オブジェクトの DataTableDataColumnCollection追加します。

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)

ソース:
DataColumn.cs
ソース:
DataColumn.cs
ソース:
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 または空の文字列 ("") に設定した場合は、列コレクションに追加するときに既定の名前が指定されます。

次の例では、 を指定して 新しい DataColumn を作成します 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

こちらもご覧ください

適用対象

DataColumn(String, Type)

ソース:
DataColumn.cs
ソース:
DataColumn.cs
ソース:
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を指定して新しい 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)

ソース:
DataColumn.cs
ソース:
DataColumn.cs
ソース:
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)

ソース:
DataColumn.cs
ソース:
DataColumn.cs
ソース:
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 値のいずれか 1 つ。

例外

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 参照してください。

こちらもご覧ください

適用対象