DataColumn.DefaultValue 属性

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

Source:

DataColumn.cs

在创建新行时获取或设置列的默认值。

public:
 property System::Object ^ DefaultValue { System::Object ^ get(); void set(System::Object ^ value); };

[System.ComponentModel.TypeConverter(typeof(System.Data.DefaultValueTypeConverter))]
public object DefaultValue { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Data.DefaultValueTypeConverter))>]
member this.DefaultValue : obj with get, set

Public Property DefaultValue As Object

属性值

Object

适合于列的 DataType 的值。

属性

TypeConverterAttribute

例外

InvalidCastException

在添加行时，默认值不是列的数据类型的实例。

示例

以下示例创建多个 DataColumn 具有不同数据类型的对象，并为每个列设置适当的默认值。

Private Sub CreateColumns()
    Dim column As DataColumn
    Dim table As New DataTable
 
    column = New DataColumn
    With column
       .DataType = System.Type.GetType("System.String")
       .DefaultValue = "Address"
       .Unique = False
    End With
    table.Columns.Add(column)
    
    column = New DataColumn
    With column
       .DataType = System.Type.GetType("System.Int32")
       .DefaultValue = 100
    End With
    table.Columns.Add(column)
 
    column = New DataColumn
    With column
       .DataType = System.Type.GetType("System.DateTime")
       .DefaultValue = "1/1/2001"
    End With
    table.Columns.Add(column)
 
    Dim row As DataRow
    ' Add one row. Since it has default values, 
    ' no need to set values yet.
    row = table.NewRow
   
    table.Rows.Add(row)
 End Sub

注解

默认值是创建 时自动分配给列 DataRow 的值 (例如，创建 的日期和时间 DataRow 。

当 设置为 true 时 AutoIncrement ，不能有默认值。

可以使用 类的 属性创建新行 ItemArray ， DataRow 并为 方法传递值数组。 对于具有默认值的列来说，这是一个潜在问题，因为其值是自动生成的。 若要将 ItemArray 属性与此类列一起使用，请将 放置在 null 数组中列的位置。 有关更多信息，请参见 ItemArray 属性。

另请参阅

• DataType
• ItemArray
• AutoIncrement
• UniqueConstraint
• 在 ADO.NET 中使用数据集