DataColumn.DefaultValue Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Standardwert für die Spalte ab, wenn Sie neue Zeilen erstellen, oder legt den Standardwert 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, setmember this.DefaultValue : obj with get, set[<System.ComponentModel.TypeConverter(typeof(System.Data.DefaultValueTypeConverter))>]
[<System.Data.DataSysDescription("DataColumnDefaultValueDescr")>]
member this.DefaultValue : obj with get, setPublic Property DefaultValue As ObjectEigenschaftswert
Ein Wert, der für die Spalte DataTypegeeignet ist.
- Attribute
Ausnahmen
Wenn Sie eine Zeile hinzufügen, ist der Standardwert keine Instanz des Datentyps der Spalte.
Beispiele
Im folgenden Beispiel werden mehrere DataColumn Objekte mit unterschiedlichen Datentypen erstellt und für jede Spalte geeignete Standardwerte 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 der Spalte automatisch zugewiesen wird, wenn ein DataRow Objekt erstellt wird (z. B. das Datum und die Uhrzeit der DataRow Erstellung.
Wenn AutoIncrement "true" festgelegt ist, kann kein Standardwert vorhanden sein.
Sie können eine neue Zeile mit der ItemArray Eigenschaft der DataRow Klasse erstellen und die Methode an ein Array von Werten übergeben. Dies ist ein potenzielles Problem für eine Spalte mit einem Standardwert, da der Wert automatisch generiert wird. Wenn Sie die ItemArray Eigenschaft mit einer solchen Spalte verwenden möchten, platzieren null Sie die Position der Spalte im Array. Weitere Informationen finden Sie in den Ausführungen zur ItemArray-Eigenschaft.
