Поделиться через


DataColumn.DefaultValue Свойство

Определение

Возвращает или задает значение по умолчанию для столбца при создании новых строк.

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; }
public object DefaultValue { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.Data.DefaultValueTypeConverter))]
[System.Data.DataSysDescription("DataColumnDefaultValueDescr")]
public object DefaultValue { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Data.DefaultValueTypeConverter))>]
member this.DefaultValue : obj with get, set
member this.DefaultValue : obj with get, set
[<System.ComponentModel.TypeConverter(typeof(System.Data.DefaultValueTypeConverter))>]
[<System.Data.DataSysDescription("DataColumnDefaultValueDescr")>]
member this.DefaultValue : obj with get, set
Public Property DefaultValue As Object

Значение свойства

Значение, соответствующее DataType столбца.

Атрибуты

Исключения

При добавлении строки значение по умолчанию не является экземпляром типа данных столбца.

Примеры

В следующем примере создается несколько 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.

Применяется к

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