DataColumn.DefaultValue Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Data

Zestaw:: System.Data.Common.dll

Zestaw:: System.Data.dll

Zestaw:: netstandard.dll

Źródło:: DataColumn.cs

Źródło:: DataColumn.cs

Źródło:: DataColumn.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia wartość domyślną kolumny podczas tworzenia nowych wierszy.

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

Wartość właściwości

Object

Wartość odpowiednia dla kolumny DataType.

Atrybuty: TypeConverterAttribute DataSysDescriptionAttribute

Wyjątki

InvalidCastException

Podczas dodawania wiersza wartość domyślna nie jest wystąpieniem typu danych kolumny.

Przykłady

Poniższy przykład tworzy kilka DataColumn obiektów, które mają różne typy danych i ustawia odpowiednie wartości domyślne dla każdej kolumny.

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

Uwagi

Wartość domyślna to wartość, która jest automatycznie przypisywana do kolumny po DataRow utworzeniu elementu (na przykład data i godzina utworzenia DataRow .

Po AutoIncrement ustawieniu wartości true nie może istnieć wartość domyślna.

Nowy wiersz można utworzyć przy użyciu ItemArray właściwości DataRow klasy i przekazać metodę tablicy wartości. Jest to potencjalny problem dla kolumny z wartością domyślną, ponieważ jego wartość jest generowana automatycznie. Aby użyć ItemArray właściwości z taką kolumną, umieść null w pozycji kolumny w tablicy. Aby uzyskać więcej informacji, zobacz ItemArray właściwość .

Dotyczy