DataColumn クラス

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

DataColumn クラス

DataTable 内の列のスキーマを表します。

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

Visual Basic (宣言)

Public Class DataColumn
    Inherits MarshalByValueComponent

Visual Basic (使用法)

Dim instance As DataColumn

C#

public class DataColumn : MarshalByValueComponent

C++

public ref class DataColumn : public
 MarshalByValueComponent

J#

public class DataColumn extends MarshalByValueComponent

JScript

public class DataColumn extends
 MarshalByValueComponent

解説

DataColumn は、DataTable のスキーマを作成するための基本的なビルド ブロックです。スキーマを作成するには、1 つ以上の DataColumn オブジェクトを DataColumnCollection に追加します。詳細については、「テーブルへの列の追加」を参照してください。

各 DataColumn には、その DataColumn に格納されるデータの種類を決定する DataType プロパティがあります。たとえば、データ型を整数、文字列、10 進数などに制限できます。通常、DataTable に格納されるデータは、元のデータ ソースにマージ バックされるため、データ型をデータ ソース内のデータ型と一致させる必要があります。詳細については、「データ プロバイダのデータ型から .NET Framework のデータ型への変換」を参照してください。

AllowDBNull、Unique、ReadOnly などのプロパティを使用して、データの入力と更新に対して制限を設け、データの整合性が保証されるようにします。AutoIncrement、AutoIncrementSeed、AutoIncrementStep の各プロパティを使用して、自動データ生成も制御できます。AutoIncrement 列の詳細については、「AutoIncrement 列の作成」を参照してください。詳細については、「テーブルの主キーの定義」を参照してください。

UniqueConstraint を作成し、DataColumn が属する DataTable の ConstraintCollection にこの制約を追加して、DataColumn 内の値が一意であるようにすることもできます。詳細については、「テーブルへの制約の追加」を参照してください。

DataColumn オブジェクト間のリレーションシップを作成するには、DataRelation オブジェクトを作成し、このオブジェクトを DataSet の DataRelationCollection に追加します。

DataColumn オブジェクトの Expression プロパティを使用して、列内の値を計算したり、集約列を作成したりできます。詳細については、「式列の作成」を参照してください。

使用例

複数の DataColumn オブジェクトを使用して DataTable を作成する例を次に示します。

Visual Basic

Private Sub MakeTable()
    ' Create a DataTable. 
    Dim table As DataTable = new
 DataTable("Product") 

    ' Create a DataColumn and set various properties. 
    Dim column As DataColumn = New
 DataColumn 
    column.DataType = System.Type.GetType("System.Decimal")
 
    column.AllowDBNull = False 
    column.Caption = "Price"  
    column.ColumnName = "Price" 
    column.DefaultValue = 25 

    ' Add the column to the table. 
    table.Columns.Add(column) 

    ' Add 10 rows and set values. 
    Dim row As DataRow 
    Dim i As Integer  
    For i = 0 to 9 
        row = table.NewRow() 
        row("Price") = i + 1 

        ' Be sure to add the new row to 
        ' the DataRowCollection. 
        table.Rows.Add(row) 
    Next i 
End Sub

C#

private void MakeTable()
{ 
    // Create a DataTable. 
    DataTable table = new DataTable("Product");

    // Create a DataColumn and set various properties. 
    DataColumn column = new DataColumn(); 
    column.DataType = System.Type.GetType("System.Decimal"); 
    column.AllowDBNull = false; 
    column.Caption = "Price"; 
    column.ColumnName = "Price"; 
    column.DefaultValue = 25; 

    // Add the column to the table. 
    table.Columns.Add(column); 

    // Add 10 rows and set values. 
    DataRow row; 
    for(int i = 0; i < 10; i++)
    { 
        row = table.NewRow(); 
        row["Price"] = i + 1; 

        // Be sure to add the new row to the 
        // DataRowCollection. 
        table.Rows.Add(row); 
    } 
}

継承階層

System.Object
   System.ComponentModel.MarshalByValueComponent
    System.Data.DataColumn

スレッド セーフ

この型は、マルチスレッド読み取り操作に対して安全です。すべての書き込み操作の同期をとる必要があります。

プラットフォーム

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 メンバ
System.Data 名前空間
Add
DataColumnCollection
Constraints
ConstraintCollection クラス
System.Windows.Forms.DataGrid
DataRow
DataTable
DataSet
NewRow
DataRowCollection
UniqueConstraint