DataColumn.DefaultValue Propriété

Définition

Espace de noms:

System.Data

Assemblys:

netstandard.dll, System.Data.Common.dll

Source:

DataColumn.cs

Obtient ou définit la valeur par défaut de la colonne lorsque vous créez de nouvelles lignes.

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

Valeur de propriété

Object

Valeur appropriée à la colonne DataType.

Attributs

TypeConverterAttribute

Exceptions

InvalidCastException

Lorsque vous ajoutez une ligne, la valeur par défaut n’est pas une instance du type de données de la colonne.

Exemples

L’exemple suivant crée plusieurs objets qui ont différents DataColumn types de données et définit les valeurs par défaut appropriées pour chaque colonne.

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

Remarques

Une valeur par défaut est la valeur qui est automatiquement affectée à la colonne lorsqu’un DataRow est créé (par exemple, la date et l’heure de création de la DataRow colonne.

Quand AutoIncrement la valeur est true, il ne peut y avoir aucune valeur par défaut.

Vous pouvez créer une ligne à l’aide de la ItemArray propriété de la DataRow classe et transmettre la méthode à un tableau de valeurs. Il s’agit d’un problème potentiel pour une colonne avec une valeur par défaut, car sa valeur est générée automatiquement. Pour utiliser la ItemArray propriété avec une telle colonne, placez-la null dans la position de la colonne dans le tableau. Pour plus d’informations, consultez la propriété ItemArray.

Voir aussi

• DataType
• ItemArray
• AutoIncrement
• UniqueConstraint
• Utilisation de DataSets dans ADO.NET