DataColumn.DefaultValue Свойство

Определение

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

System.Data

Сборка:

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