DataColumn.DefaultValue Eigenschap

Definitie

Hiermee haalt u de standaardwaarde voor de kolom op of stelt u deze in wanneer u nieuwe rijen maakt.

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

Waarde van eigenschap

Een waarde die geschikt is voor de kolom DataType.

Kenmerken

Uitzonderingen

Wanneer u een rij toevoegt, is de standaardwaarde geen exemplaar van het gegevenstype van de kolom.

Voorbeelden

In het volgende voorbeeld worden verschillende DataColumn objecten gemaakt met verschillende gegevenstypen en worden de juiste standaardwaarden ingesteld op elke kolom.

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

Opmerkingen

Een standaardwaarde is de waarde die automatisch wordt toegewezen aan de kolom wanneer een DataRow wordt gemaakt (bijvoorbeeld de datum en tijd waarop de DataRow kolom is gemaakt).

Wanneer AutoIncrement deze is ingesteld op true, kan er geen standaardwaarde zijn.

U kunt een nieuwe rij maken met behulp van de ItemArray eigenschap van de DataRow klasse en de methode doorgeven aan een matrix met waarden. Dit is een potentieel probleem voor een kolom met een standaardwaarde omdat de waarde automatisch wordt gegenereerd. Als u de ItemArray eigenschap met een dergelijke kolom wilt gebruiken, plaatst null u deze in de positie van de kolom in de matrix. Voor meer informatie, zie de eigenschap ItemArray.

Van toepassing op

Zie ook