DataColumn.DefaultValue Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Origine:
DataColumn.cs
Origine:
DataColumn.cs
Origine:
DataColumn.cs

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

L'esempio seguente crea diversi DataColumn oggetti con tipi di dati diversi e imposta i valori predefiniti appropriati su 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 della DataRow creazione.

Se AutoIncrement è impostato su true, non è possibile che non esista alcun valore predefinito.

È possibile creare una nuova riga usando la ItemArray proprietà della DataRow classe e passare 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 tale colonna, posizionare null nella posizione della colonna nella matrice. Per altre informazioni, vedere la proprietà ItemArray.

Si applica a

Vedi anche