DataColumn.DefaultValue Eigenschaft

  • Referenz

Definition

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Quelle:
DataColumn.cs
Quelle:
DataColumn.cs
Quelle:
DataColumn.cs

Ruft beim Erstellen neuer Zeilen den Standardwert für die Spalte ab oder legt diesen fest.

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

Eigenschaftswert

Object

Ein Wert, der dem DataType der Spalte entspricht.

Attribute
TypeConverterAttribute DataSysDescriptionAttribute

Ausnahmen

InvalidCastException

Beim Hinzufügen einer Zeile stellt der Standardwert keine Instanz des Datentyps der Spalte dar.

Beispiele

Im folgenden Beispiel werden mehrere DataColumn Objekte mit unterschiedlichen Datentypen erstellt und die entsprechenden Standardwerte für jede Spalte festgelegt.

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

Hinweise

Ein Standardwert ist der Wert, der automatisch der Spalte zugewiesen wird, wenn ein DataRow erstellt wird (z. B. das Datum und die Uhrzeit der DataRow Erstellung.

Wenn AutoIncrement auf TRUE festgelegt ist, kann kein Standardwert vorhanden sein.

Sie können eine neue Zeile erstellen, indem Sie die ItemArray -Eigenschaft der DataRow -Klasse verwenden und der Methode ein Array von Werten übergeben. Dies ist ein potenzielles Problem für eine Spalte mit einem Standardwert, da ihr Wert automatisch generiert wird. Um die ItemArray -Eigenschaft mit einer solchen Spalte zu verwenden, platzieren Sie null an der Position der Spalte im Array. Weitere Informationen finden Sie in den Ausführungen zur ItemArray-Eigenschaft.

Gilt für:

Weitere Informationen