DataColumn.DefaultValue プロパティ

.NET Framework クラス ライブラリ リファレンス

DataColumn.DefaultValue プロパティ

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

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Property DefaultValue As
 Object

Visual Basic (使用法)

Dim instance As DataColumn
Dim value As Object

value = instance.DefaultValue

instance.DefaultValue = value

C#

public Object DefaultValue { get; set;
 }

C++

public:
property Object^ DefaultValue {
    Object^ get ();
    void set (Object^ value);
}

J#

/** @property */
public Object get_DefaultValue ()

/** @property */
public void set_DefaultValue (Object value)

JScript

public function get DefaultValue
 () : Object

public function set DefaultValue
 (value : Object)

プロパティ値
この列の DataType に適切な値。

例外

例外の種類	条件
InvalidCastException	行を追加する場合、既定値はこの列のデータ型のインスタンスではありません。

解説

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

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

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

使用例

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

Visual Basic

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataColumn クラス
DataColumn メンバ
System.Data 名前空間
DataColumn.DataType プロパティ
ItemArray
DataColumn.AutoIncrement プロパティ
UniqueConstraint