DataColumn.DefaultValue プロパティ

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

Public Property DefaultValue As Object
[C#]
public object DefaultValue {get; set;}
[C++]
public: __property Object* get_DefaultValue();public: __property void set_DefaultValue(Object*);
[JScript]
public function get DefaultValue() : Object;public function set DefaultValue(Object);

プロパティ値

この列の DataType に適切な値。

例外

解説

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

AutoIncrement が true に設定されている場合、既定値はありません。

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

使用例

[Visual Basic] データ型が異なる複数の DataColumn オブジェクトを作成し、各列に適切な既定値を設定する例を次に示します。

 
Private Sub CreateColumns()
    Dim myCol As DataColumn
    Dim myTable As New DataTable
 
    myCol = New DataColumn
    With myCol
       .DataType = System.Type.GetType("System.String")
       .DefaultValue = "Address"
       .Unique = False
    End With
    myTable.Columns.Add(myCol)
    
    myCol = New DataColumn
    With myCol
       .DataType = System.Type.GetType("System.Int32")
       .DefaultValue = 100
    End With
    myTable.Columns.Add(myCol)
 
    myCol = New DataColumn
    With myCol
       .DataType = System.Type.GetType("System.DateTime")
       .DefaultValue = "1/1/2001"
    End With
    myTable.Columns.Add(myCol)
 
    Dim myRow As DataRow
    ' Add one row. Since it has default values, no need to set values yet.
    myRow = myTable.NewRow
   
    myTable.Rows.Add(myRow)
 End Sub

[C#, C++, JScript] C#、C++、および JScript のサンプルはありません。Visual Basic のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

DataColumn クラス | DataColumn メンバ | System.Data 名前空間 | DataType | ItemArray | AutoIncrement | UniqueConstraint