DataColumn.DefaultValue Propriedade

  • Referência

Definição

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Origem:
DataColumn.cs
Origem:
DataColumn.cs
Origem:
DataColumn.cs

Obtém ou define o valor padrão para a coluna ao criar novas linhas.

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

Valor da propriedade

Object

Um valor apropriado para DataType da coluna.

Atributos
TypeConverterAttribute DataSysDescriptionAttribute

Exceções

InvalidCastException

Quando você estiver adicionando uma linha, o valor padrão não será uma instância do tipo de dados da coluna.

Exemplos

O exemplo a seguir cria vários DataColumn objetos que têm tipos de dados diferentes e define os valores padrão 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

Comentários

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

Quando AutoIncrement é definido como true, não pode haver nenhum valor padrão.

Você pode criar uma nova linha usando a ItemArray propriedade da DataRow classe e passando ao método uma matriz de valores. Esse é um problema potencial para uma coluna com um valor padrão porque seu valor é gerado automaticamente. Para usar a ItemArray propriedade com essa coluna, coloque null na posição da coluna na matriz. Para obter mais informações, consulte a propriedade ItemArray.

Aplica-se a

Confira também