DataColumn.DefaultValue Vlastnost

Reference

Definice

Obor názvů:: System.Data

Sestavení:: System.Data.Common.dll

Sestavení:: System.Data.dll

Sestavení:: netstandard.dll

Zdroj:: DataColumn.cs

Zdroj:: DataColumn.cs

Zdroj:: DataColumn.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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í příslušné 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 vytvoření objektu DataRow (například datum a čas DataRow vytvoření sloupce).

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

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

Platí pro