DataColumn.DefaultValue Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Data
Ensamblado:
System.Data.Common.dll
Ensamblado:
System.Data.dll
Ensamblado:
netstandard.dll
Source:
DataColumn.cs
Source:
DataColumn.cs
Source:
DataColumn.cs

Obtiene o establece el valor predeterminado para la columna al crear nuevas filas.

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

Valor de propiedad

Object

Valor correspondiente al DataType de la columna.

Atributos
TypeConverterAttribute DataSysDescriptionAttribute

Excepciones

InvalidCastException

Cuando se agrega una fila, el valor predeterminado no es una instancia del tipo de datos de la columna.

Ejemplos

En el ejemplo siguiente se crean varios DataColumn objetos que tienen distintos tipos de datos y se establecen los valores predeterminados adecuados para cada columna.

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

Comentarios

Un valor predeterminado es el valor que se asigna automáticamente a la columna cuando se crea un DataRow objeto (por ejemplo, la fecha y hora en que se creó.DataRow

Cuando AutoIncrement se establece en true, no puede haber ningún valor predeterminado.

Puede crear una nueva fila mediante la ItemArray propiedad de la DataRow clase y pasar el método una matriz de valores. Se trata de un posible problema para una columna con un valor predeterminado porque su valor se genera automáticamente. Para usar la ItemArray propiedad con este tipo de columna, coloque null en la posición de la columna en la matriz. Para obtener más información, vea la propiedad ItemArray.

Se aplica a

Consulte también