DataColumn.DefaultValue Свойство

Определение

Пространство имен:

System.Data

Сборки:

netstandard.dll, System.Data.Common.dll

Исходный код:

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, значение по умолчанию не может быть.

Вы можете создать новую строку с помощью ItemArray свойства DataRow класса и передать метод массиву значений. Это потенциальная проблема для столбца со значением по умолчанию, так как его значение создается автоматически. Чтобы использовать ItemArray свойство с таким столбцом, поместите null в положение столбца в массиве. Дополнительные сведения см. в свойстве ItemArray.

См. также раздел

• DataType
• ItemArray
• AutoIncrement
• UniqueConstraint
• Использование наборов данных в ADO.NET