Udostępnij za pośrednictwem

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

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

Zobacz też