DataColumn.DefaultValue Propriedade

Definição

Espaço de Nomes:
System.Data
Assemblagem:
System.Data.dll
Assemblagem:
netstandard.dll

Obtém ou define o valor padrão da coluna quando estás a criar novas linhas.

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

Valor de Propriedade

Object

Um valor apropriado ao DataType.

Atributos
TypeConverterAttribute DataSysDescriptionAttribute

Exceções

InvalidCastException

Quando está a adicionar uma linha, o valor padrão não é uma instância do tipo de dado da coluna.

Exemplos

O exemplo seguinte cria vários DataColumn objetos com diferentes tipos de dados e define valores predefinidos apropriados para cada coluna.

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

Observações

Um valor padrão é o valor que é automaticamente atribuído à coluna quando a DataRow é criado (por exemplo, a data e hora em que foi DataRow criado).

Quando AutoIncrement está definido como verdadeiro, não pode haver valor padrão.

Podes criar uma nova linha usando a ItemArray propriedade da DataRow classe e passar ao método um array de valores. Isto é um problema potencial para uma coluna com valor padrão porque o seu valor é gerado automaticamente. Para usar a ItemArray propriedade com tal coluna, coloque null na posição da coluna no array. Para obter mais informações, consulte a propriedade ItemArray.

Aplica-se a

Ver também