DataColumn.DefaultValue Proprietà

Definizione

Spazio dei nomi:

System.Data

Assembly:

netstandard.dll, System.Data.Common.dll

Origine:

DataColumn.cs

Ottiene o imposta il valore predefinito per la colonna quando si creano 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; }

[<System.ComponentModel.TypeConverter(typeof(System.Data.DefaultValueTypeConverter))>]
member this.DefaultValue : obj with get, set

Public Property DefaultValue As Object

Valore della proprietà

Object

Valore appropriato per l'oggetto della DataTypecolonna.

Attributi

TypeConverterAttribute

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 DataRow di creazione di .

Se AutoIncrement è impostato su true, non può essere presente 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 ulteriori informazioni, consultare la proprietà ItemArray.

Vedi anche

• DataType
• ItemArray
• AutoIncrement
• UniqueConstraint
• Uso di DataSet in ADO.NET