DataColumn.DefaultValue Propriété

Référence

Définition

Espace de noms:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Source:: DataColumn.cs

Source:: DataColumn.cs

Source:: DataColumn.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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; }

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

Valeur de propriété

Object

Valeur appropriée pour le DataType de la colonne.

Attributs: TypeConverterAttribute DataSysDescriptionAttribute

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 DataColumn objets qui ont différents 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 lors de la création d’un DataRow (par exemple, la date et l’heure de création du DataRow .

Quand AutoIncrement est défini sur 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 passer à 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 null dans la position de la colonne dans le tableau. Pour plus d'informations, consultez la propriété ItemArray.

S’applique à