DataColumn コンストラクタ

.NET Framework クラス ライブラリ リファレンス

DataColumn コンストラクタ (String, Type, String)

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

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    columnName As String, _
    dataType As Type, _
    expr As String _
)

Visual Basic (使用法)

Dim columnName As String
Dim dataType As Type
Dim expr As String

Dim instance As New DataColumn(columnName,
 dataType, expr)

C#

public DataColumn (
    string columnName,
    Type dataType,
    string expr
)

C++

public:
DataColumn (
    String^ columnName, 
    Type^ dataType, 
    String^ expr
)

J#

public DataColumn (
    String columnName, 
    Type dataType, 
    String expr
)

JScript

public function DataColumn (
    columnName : String, 
    dataType : Type, 
    expr : String
)

パラメータ

columnName

作成する列の名前を表す文字列。null 参照 (Visual Basic では Nothing) または空の文字列 ("") に設定した場合は、列コレクションに追加するときに既定の名前が指定されます。

dataType

サポートされる DataType。

expr

この列の作成に使用される式。詳細については、Expression プロパティのトピックを参照してください。

例外

例外の種類	条件
ArgumentNullException	dataType が指定されませんでした。

使用例

計算列を作成する例を次に示します。

Visual Basic

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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataColumn クラス
DataColumn メンバ
System.Data 名前空間
DefaultValue
ColumnName
Caption
DataTable
DataType
Expression

DataColumn コンストラクタ (String)

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

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    columnName As String _
)

Visual Basic (使用法)

Dim columnName As String

Dim instance As New DataColumn(columnName)

C#

public DataColumn (
    string columnName
)

C++

public:
DataColumn (
    String^ columnName
)

J#

public DataColumn (
    String columnName
)

JScript

public function DataColumn (
    columnName : String
)

パラメータ

columnName

作成する列の名前を表す文字列。null 参照 (Visual Basic では Nothing) または空の文字列 ("") に設定した場合は、列コレクションに追加するときに既定の名前が指定されます。

解説

既定では、列の固有の名前が Caption プロパティ値になります。

使用例

指定した ColumnName を使用して新しい DataColumn を作成する例を次に示します。

Visual Basic

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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataColumn クラス
DataColumn メンバ
System.Data 名前空間
ColumnName
Caption
DefaultValue
DataTable
DataType

DataColumn コンストラクタ

DataColumn クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
DataColumn ()	DataColumn クラスの新しいインスタンスを文字列型として初期化します。 .NET Compact Framework によってサポートされています。
DataColumn (String)	指定した列名を使用して、DataColumn クラスの新しいインスタンスを文字列型として初期化します。 .NET Compact Framework によってサポートされています。
DataColumn (String, Type)	指定した列名とデータ型を使用して DataColumn クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
DataColumn (String, Type, String)	指定した名前、データ型、および式を使用して DataColumn クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
DataColumn (String, Type, String, MappingType)	指定した名前、データ型、式、およびこの列が属性かどうかを決定する値を使用して、DataColumn クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。

参照

関連項目

DataColumn クラス
DataColumn メンバ
System.Data 名前空間
ColumnName
Caption
DefaultValue
DataTable
DataType

DataColumn コンストラクタ (String, Type)

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

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    columnName As String, _
    dataType As Type _
)

Visual Basic (使用法)

Dim columnName As String
Dim dataType As Type

Dim instance As New DataColumn(columnName,
 dataType)

C#

public DataColumn (
    string columnName,
    Type dataType
)

C++

public:
DataColumn (
    String^ columnName, 
    Type^ dataType
)

J#

public DataColumn (
    String columnName, 
    Type dataType
)

JScript

public function DataColumn (
    columnName : String, 
    dataType : Type
)

パラメータ

columnName

作成する列の名前を表す文字列。null 参照 (Visual Basic では Nothing) または空の文字列 ("") に設定した場合は、列コレクションに追加するときに既定の名前が指定されます。

dataType

サポートされる DataType。

例外

例外の種類	条件
ArgumentNullException	dataType が指定されませんでした。

使用例

指定した ColumnName と DataType を使用して新しい DataColumn を作成する例を次に示します。

Visual Basic

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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataColumn クラス
DataColumn メンバ
System.Data 名前空間
DefaultValue
ColumnName
Caption
DataTable
DataType

DataColumn コンストラクタ (String, Type, String, MappingType)

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

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    columnName As String, _
    dataType As Type, _
    expr As String, _
    type As MappingType _
)

Visual Basic (使用法)

Dim columnName As String
Dim dataType As Type
Dim expr As String
Dim type As MappingType

Dim instance As New DataColumn(columnName,
 dataType, expr, type)

C#

public DataColumn (
    string columnName,
    Type dataType,
    string expr,
    MappingType type
)

C++

public:
DataColumn (
    String^ columnName, 
    Type^ dataType, 
    String^ expr, 
    MappingType type
)

J#

public DataColumn (
    String columnName, 
    Type dataType, 
    String expr, 
    MappingType type
)

JScript

public function DataColumn (
    columnName : String, 
    dataType : Type, 
    expr : String, 
    type : MappingType
)

パラメータ

columnName

作成する列の名前を表す文字列。null 参照 (Visual Basic では Nothing) または空の文字列 ("") に設定した場合は、列コレクションに追加するときに既定の名前が指定されます。

dataType

サポートされる DataType。

expr

この列の作成に使用される式。詳細については、Expression プロパティのトピックを参照してください。

type

MappingType 値の 1 つ。

例外

例外の種類	条件
ArgumentNullException	dataType が指定されませんでした。

解説

引数 type は ColumnMapping プロパティを設定します。このプロパティは、DataSet を XML ドキュメントに変換した場合に DataColumn を変換する方法を指定します。たとえば、この列に "fName" という名前が指定され、値 "Bob" が格納されていて、type が MappingType.Attribute に設定されている場合、この列の XML 要素は次のようになります。

<Name fName = 'Bob'/>

列を要素または属性に変換する方法の詳細については、ColumnMapping プロパティのトピックを参照してください。

使用例

計算列を作成する例を次に示します。

Visual Basic

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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataColumn クラス
DataColumn メンバ
System.Data 名前空間
ColumnName
ColumnMapping
Caption
DefaultValue
DataTable
DataType

DataColumn コンストラクタ ()

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

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New DataColumn

C#

public DataColumn ()

C++

public:
DataColumn ()

J#

public DataColumn ()

JScript

public function DataColumn ()

解説

作成された DataColumn オブジェクトには、既定の ColumnName と Caption がありません。これを DataColumnCollection に追加するときに、ColumnName に名前が割り当てられていない場合、既定の名前 ("Column1"、"Column2" など) が生成されます。

使用例

新しい DataColumn を作成し、各種のプロパティを設定し、この列を DataTable オブジェクトの DataColumnCollection に追加する例を次に示します。

Visual Basic

Private Sub AddDataColumn(ByVal
 table As DataTable)
    Dim column As DataColumn = 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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataColumn クラス
DataColumn メンバ
System.Data 名前空間
ColumnName
Caption
DefaultValue
DataTable
DataType