DataColumn.DefaultValue 属性

定义

命名空间:

System.Data

程序集:

netstandard.dll, 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 ）。

如果 AutoIncrement 设置为 true，则不能有默认值。

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

另请参阅

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