Sdílet prostřednictvím

DataColumn.DefaultValue Vlastnost

Definice

Obor názvů:
System.Data
Sestavení:
netstandard.dll, System.Data.Common.dll
Sestavení:
System.Data.Common.dll
Sestavení:
System.Data.dll
Sestavení:
netstandard.dll
Zdroj:
DataColumn.cs
Zdroj:
DataColumn.cs
Zdroj:
DataColumn.cs
Zdroj:
DataColumn.cs
Zdroj:
DataColumn.cs

Získá nebo nastaví výchozí hodnotu sloupce při vytváření nových řádků.

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

Hodnota vlastnosti

Object

Hodnota odpovídající sloupci DataType.

Atributy
TypeConverterAttribute DataSysDescriptionAttribute

Výjimky

InvalidCastException

Když přidáváte řádek, výchozí hodnota není instancí datového typu sloupce.

Příklady

Následující příklad vytvoří několik DataColumn objektů, které mají různé datové typy, a nastaví odpovídající výchozí hodnoty pro každý sloupec.

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

Poznámky

Výchozí hodnota je hodnota, která se automaticky přiřadí ke sloupci při DataRow vytvoření (například datum a čas DataRow vytvoření.

Pokud AutoIncrement je nastavena hodnota true, nemůže existovat žádná výchozí hodnota.

Můžete vytvořit nový řádek pomocí ItemArray vlastnosti DataRow třídy a předat metodu pole hodnot. Jedná se o potenciální problém sloupce s výchozí hodnotou, protože jeho hodnota se vygeneruje automaticky. Pokud chcete použít ItemArray vlastnost s takovým sloupcem, umístěte null ji do pozice sloupce v poli. Další informace najdete ve vlastnosti ItemArray.

Platí pro

Viz také