DataColumn.DataType 属性

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

Source:

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然后将一行添加到 表中。

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 ，并且您尝试将类型设置为除整数类型以外的任何内容，则会生成异常。

注意

数据类型列Byte[]在某些情况下需要特殊处理，因为与基.NET Framework数据类型不同，它是引用数据类型。 如果将数据类型Byte[]的列用作 PrimaryKey，或用作 Sort 的 DataView或 RowFilter 键，则对列值的任何更改都必须涉及将Byte[]列值分配给单独实例化Byte[]的对象。 需要此分配才能触发排序、筛选和主键操作所使用的内部索引的更新。 下面的示例对此进行演示：

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

注意

尽管可以将列定义为除基.NET Framework数据类型和 Byte[]之外的数据类型，但此类列将被视为用户定义的类型，但需遵守以下使用限制。 (有关用户定义的类型的详细信息，请参阅 创建和使用 User-Defined 类型)

• 列不能是 或 Select 表达式的一RowFilter部分。

• 如果该列用作 PrimaryKey，或用作 Sort 或 ， DataView则必须将其视为不可变字段;列数据添加到表后不得更改。

• 它 ColumnMapping 只能设置为 MappingType.Element。

• 实现列的数据类型的类必须使用 标记 SerializableAttribute，并在必要时实现 ISerializable 或 IXmlSerializable 接口。

• 对更改跟踪的支持有限。 若要利用DataTable类的更改跟踪机制，实现列数据类型的类必须实现 IChangeTracking 接口，或通过对行调用 SetModified 或将列值对象分配给单独实例化的列值对象来接管通知 DataRow 的责任。

另请参阅

• Type
• GetType()
• 在 ADO.NET 中使用数据集