DataColumn.DataType プロパティ

定義

名前空間:

System.Data

アセンブリ:

System.Data.Common.dll

ソース:

DataColumn.cs

列に格納されているデータの型を取得または設定します。

public:
 property Type ^ DataType { Type ^ get(); void set(Type ^ value); };

[System.ComponentModel.TypeConverter(typeof(System.Data.ColumnTypeConverter))]
public Type DataType { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Data.ColumnTypeConverter))>]
member this.DataType : Type with get, set

Public Property DataType As Type

プロパティ値

Type

列のデータ型を表す Type オブジェクト。

属性

TypeConverterAttribute

例外

ArgumentException

この列には既にデータが格納されています。

例

次の例では、複数のデータ型の列を DataTableに追加し、テーブルに 1 つの行を追加します。

public DataTable MakeDataTable(){

    DataTable myTable;
    DataRow myNewRow;
    // Create a new DataTable.
    myTable = new DataTable("My Table");

    // Create DataColumn objects of data types.
    DataColumn colString = new DataColumn("StringCol");
    colString.DataType = System.Type.GetType("System.String");
    myTable.Columns.Add(colString);

    DataColumn colInt32 = new DataColumn("Int32Col");
    colInt32.DataType = System.Type.GetType("System.Int32");
    myTable.Columns.Add(colInt32);

    DataColumn colBoolean = new DataColumn("BooleanCol");
    colBoolean.DataType = System.Type.GetType("System.Boolean");
    myTable.Columns.Add(colBoolean);

    DataColumn colTimeSpan = new DataColumn("TimeSpanCol");
    colTimeSpan.DataType = System.Type.GetType("System.TimeSpan");
    myTable.Columns.Add(colTimeSpan);

    DataColumn colDateTime = new DataColumn("DateTimeCol");
    colDateTime.DataType = System.Type.GetType("System.DateTime");
    myTable.Columns.Add(colDateTime);

    DataColumn colDecimal = new DataColumn("DecimalCol");
    colDecimal.DataType = System.Type.GetType("System.Decimal");
    myTable.Columns.Add(colDecimal);

    DataColumn colByteArray = new DataColumn("ByteArrayCol");
    colByteArray.DataType = System.Type.GetType("System.Byte[]");
    myTable.Columns.Add(colByteArray);

    // Populate one row with values.
    myNewRow = myTable.NewRow();

    myNewRow["StringCol"] = "Item Name";
    myNewRow["Int32Col"] = 2147483647;
    myNewRow["BooleanCol"] = true;
    myNewRow["TimeSpanCol"] = new TimeSpan(10,22,10,15,100);
    myNewRow["DateTimeCol"] = System.DateTime.Today;
    myNewRow["DecimalCol"] = 64.0021;
    myNewRow["ByteArrayCol"] = new Byte[] { 1, 5, 120 };
    myTable.Rows.Add(myNewRow);
    return myTable;
 }

Public Function MakeDataTable() As DataTable
    
    Dim myTable As DataTable 
    Dim myNewRow As DataRow 
    ' Create a new DataTable.
    myTable = New DataTable("My Table")
 
    ' Create DataColumn objects of data types.
    Dim colString As New DataColumn("StringCol")
    colString.DataType = System.Type.GetType("System.String")
    myTable.Columns.Add(colString) 
 
    Dim colInt32 As New DataColumn("Int32Col")
    colInt32.DataType = System.Type.GetType("System.Int32")
    myTable.Columns.Add(colInt32)
 
    Dim colBoolean As New DataColumn("BooleanCol")
    colBoolean.DataType = System.Type.GetType("System.Boolean")
    myTable.Columns.Add(colBoolean)
 
    Dim colTimeSpan As New DataColumn("TimeSpanCol")
    colTimeSpan.DataType = System.Type.GetType("System.TimeSpan")
    myTable.Columns.Add(colTimeSpan)
 
    Dim colDateTime As New DataColumn("DateTimeCol")
    colDateTime.DataType = System.Type.GetType("System.DateTime")
    myTable.Columns.Add(colDateTime)
 
    Dim colDecimal As New DataColumn("DecimalCol")
    colDecimal.DataType = System.Type.GetType("System.Decimal")
    myTable.Columns.Add(colDecimal)
 
    ' Populate one row with values.
    myNewRow = myTable.NewRow()
 
    myNewRow("StringCol") = "Item Name"
    myNewRow("Int32Col") = 2147483647
    myNewRow("BooleanCol") = True
    myNewRow("TimeSpanCol") = New TimeSpan(10,22,10,15,100)
    myNewRow("DateTimeCol") = System.DateTime.Today
    myNewRow("DecimalCol") = 64.0021
    myNewRow("ByteArrayCol") = New [Byte]() {1, 5, 120}
    myTable.Rows.Add(myNewRow)
    MakeDataTable = myTable  
 End Function

注釈

値を DataType 設定することは、データ ソース内のデータの正しい作成と更新を保証するために非常に重要です。

プロパティはDataType、次の基本.NET Frameworkデータ型をサポートしています。

• Boolean

• Byte

• Char

• DateTime

• Decimal

• Double

• Guid

• Int16

• Int32

• Int64

• SByte

• Single

• String

• TimeSpan

• UInt16

• UInt32

• UInt64

次の配列型と同様に、

• Byte[]

列がデータの格納を開始した後にこのプロパティを変更すると、例外が生成されます。

AutoIncrementが プロパティを設定するDataType前に にtrue設定されていて、整数型以外の型に設定しようとすると、例外が生成されます。

注意

データ型の列は、.NET Framework 基本データ型Byte[]とは異なり、参照データ型であるため、特定のケースでは特別な処理が必要です。 データ型Byte[]の列が 、 または のキー RowFilterDataViewとしてPrimaryKeySort使用される場合は、列の値を変更するには、列の値をByte[]個別にインスタンス化されたByte[]オブジェクトに割り当てる必要があります。 この割り当ては、並べ替え、フィルター処理、および主キー操作によって使用される内部インデックスの更新をトリガーするために必要です。 この例を次に示します。

byte[] columnValue = (byte[])myDataTable.Rows[0][0];
byte[] newValue = (byte[])columnValue.Clone();
newValue[1] = 2;
myDataTable.Rows[0][0] = newValue;

注意

基本Byte[].NET Frameworkデータ型および 以外のデータ型として列を定義することはできますが、このような列は、次の使用制限に従って、ユーザー定義型として扱われます。 (ユーザー定義型の詳細については、「 User-Defined 型の作成と使用」を参照してください)

• 列を または Select 式の一部にRowFilterすることはできません。

• 列が 、 または として または としてPrimaryKeySortDataView使用される場合は、変更できないフィールドとして扱う必要があります。列データは、テーブルに追加された後で変更することはできません。

• に ColumnMapping 設定 MappingType.Elementできるのは だけです。

• 列のデータ型を実装するクラスは、 でSerializableAttributeマークし、必要に応じて または IXmlSerializable インターフェイスを実装するISerializable必要があります。

• 変更の追跡のサポートは制限されています。 クラスの変更追跡メカニズムをDataTable利用するには、列のデータ型を実装するクラスで、 インターフェイスを実装IChangeTrackingするか、行で を呼び出SetModifiedすか、列値オブジェクトをDataRow個別にインスタンス化された列値オブジェクトに割り当てることによって、列の値が変更されたときに を通知する責任を引き継ぐ必要があります。

こちらもご覧ください

• Type
• GetType()
• ADO.NET でのデータセットの使用