Language

DataColumn.DefaultValue プロパティ

定義

名前空間:
System.Data
アセンブリ:
netstandard.dll, System.Data.Common.dll
アセンブリ:
System.Data.Common.dll
アセンブリ:
System.Data.dll
アセンブリ:
netstandard.dll
ソース:
DataColumn.cs
ソース:
DataColumn.cs
ソース:
DataColumn.cs
ソース:
DataColumn.cs
ソース:
DataColumn.cs

新しい行を作成するときに、列の既定値を取得または設定します。

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

プロパティ値

Object

列の DataTypeに適した値。

属性
TypeConverterAttribute DataSysDescriptionAttribute

例外

InvalidCastException

行を追加する場合、既定値は列のデータ型のインスタンスではありません。

例

次の例では、異なるデータ型を持つ複数の DataColumn オブジェクトを作成し、各列に適切な既定値を設定します。

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

注釈

既定値は、 DataRow の作成時に列に自動的に割り当てられる値です (たとえば、 DataRow が作成された日時)。

AutoIncrementが true に設定されている場合は、既定値を使用できません。

ItemArray クラスの DataRow プロパティを使用して新しい行を作成し、メソッドに値の配列を渡すことができます。 これは、既定値を持つ列の値が自動的に生成されるため、問題が発生する可能性があります。 このような列で ItemArray プロパティを使用するには、配列内の列の位置に null を配置します。 詳細については、 ItemArray プロパティを参照してください。

適用対象

こちらもご覧ください