DataColumn コンストラクター

リファレンス

定義

名前空間:: System.Data

アセンブリ:: System.Data.Common.dll

アセンブリ:: System.Data.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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しいを作成し、さまざまなプロパティを設定し、オブジェクトの 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)

ソース:: 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。

例外

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)

ソース:: 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 プロパティを参照してください。

例外

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)

ソース:: 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 つ。

例外

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)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

フィードバック

その他のリソース