DataColumn.DefaultValue Egenskap

Definition

Namnområde:
System.Data
Sammansättningar:
netstandard.dll, System.Data.Common.dll
Sammansättning:
System.Data.Common.dll
Sammansättning:
System.Data.dll
Sammansättning:
netstandard.dll
Källa:
DataColumn.cs
Källa:
DataColumn.cs
Källa:
DataColumn.cs
Källa:
DataColumn.cs
Källa:
DataColumn.cs

Hämtar eller anger standardvärdet för kolumnen när du skapar nya rader.

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

Egenskapsvärde

Object

Ett värde som är lämpligt för kolumnens DataType.

Attribut
TypeConverterAttribute DataSysDescriptionAttribute

Undantag

InvalidCastException

När du lägger till en rad är standardvärdet inte en instans av kolumnens datatyp.

Exempel

I följande exempel skapas flera DataColumn objekt som har olika datatyper och anger lämpliga standardvärden för varje kolumn.

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

Kommentarer

Ett standardvärde är det värde som automatiskt tilldelas till kolumnen när en DataRow skapas (till exempel datum och tid när den DataRow skapades.

När AutoIncrement är inställt på true kan det inte finnas något standardvärde.

Du kan skapa en ny rad med ItemArray hjälp av DataRow egenskapen för klassen och skicka metoden till en matris med värden. Det här är ett potentiellt problem för en kolumn med ett standardvärde eftersom dess värde genereras automatiskt. Om du vill använda egenskapen ItemArray med en sådan kolumn placerar du null i kolumnens position i matrisen. För mer information, se egenskapen ItemArray.

Gäller för

Se även