DataColumn コンストラクター

定義

名前空間:

System.Data

アセンブリ:

System.Data.Common.dll

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 型文字列として初期化します。

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"など) が生成されます。

こちらもご覧ください

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• ADO.NET でのデータセットの使用

DataColumn(String)

ソース:

DataColumn.cs

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

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

作成する列の名前を表す文字列。 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 。

こちらもご覧ください

• ColumnName
• Caption
• DefaultValue
• DataTable
• DataType
• ADO.NET でのデータセットの使用

DataColumn(String, Type)

ソース:

DataColumn.cs

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

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

作成する列の名前を表す文字列。 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

こちらもご覧ください

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• ADO.NET でのデータセットの使用

DataColumn(String, Type, String)

ソース:

DataColumn.cs

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

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

作成する列の名前を表す文字列。 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

こちらもご覧ください

• DefaultValue
• ColumnName
• Caption
• DataTable
• DataType
• Expression
• ADO.NET でのデータセットの使用

DataColumn(String, Type, String, MappingType)

ソース:

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

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 つ。

例外

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

こちらもご覧ください

• ColumnName
• ColumnMapping
• Caption
• DefaultValue
• DataTable
• DataType
• ADO.NET でのデータセットの使用