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

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 à

Voir aussi