DataColumn.DefaultValue Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Source:: DataColumn.cs

Source:: DataColumn.cs

Source:: DataColumn.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta il valore predefinito della colonna durante la creazione di nuove righe.

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

Valore della proprietà

Object

Valore appropriato alla proprietà DataType della colonna.

Attributi: TypeConverterAttribute DataSysDescriptionAttribute

Eccezioni

InvalidCastException

Quando si aggiunge una riga, il valore predefinito non è un'istanza del tipo di dati della colonna.

Esempio

Nell'esempio seguente vengono creati diversi DataColumn oggetti con tipi di dati diversi e vengono impostati i valori predefiniti appropriati per ogni colonna.

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

Commenti

Un valore predefinito è il valore assegnato automaticamente alla colonna quando viene creato un DataRow oggetto , ad esempio la data e l'ora di creazione di DataRow .

Se AutoIncrement è impostato su true, non può esistere alcun valore predefinito.

È possibile creare una nuova riga usando la ItemArray proprietà della DataRow classe e passando il metodo una matrice di valori. Si tratta di un potenziale problema per una colonna con un valore predefinito perché il relativo valore viene generato automaticamente. Per usare la ItemArray proprietà con una colonna di questo tipo, posizionare null nella posizione della colonna nella matrice. Per altre informazioni, vedere la proprietà ItemArray.

Si applica a