DataSet.ExtendedProperties プロパティ

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

DataSet.ExtendedProperties プロパティ

DataSet に関連付けられている、カスタマイズされたユーザー情報のコレクションを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 ExtendedProperties As PropertyCollection

Visual Basic (使用法)

Dim instance As DataSet
Dim value As PropertyCollection

value = instance.ExtendedProperties

C#

public PropertyCollection ExtendedProperties { get;
 }

C++

public:
property PropertyCollection^ ExtendedProperties {
    PropertyCollection^ get ();
}

J#

/** @property */
public PropertyCollection get_ExtendedProperties ()

JScript

public function get ExtendedProperties
 () : PropertyCollection

プロパティ値
すべてのカスタム ユーザー情報が含まれる PropertyCollection。

解説

ExtendedProperties プロパティを使用すると、カスタム情報を DataSet と共に格納できます。たとえば、データを更新する必要がある場合は、時刻を格納できます。

DataSet を XML として書き込むときに拡張プロパティを永続化する場合は、拡張プロパティを String 型にする必要があります。

使用例

ExtendedProperties プロパティによって返される PropertyCollection にカスタム プロパティを追加する例を次に示します。2 番目の例では、カスタム プロパティを取得します。

Visual Basic

Private Sub DemonstrateEnforceConstraints()
    ' Create a DataSet with one table, one column and 
    ' a UniqueConstraint.
    Dim dataSet As DataSet = New
 DataSet("dataSet")
    Dim table As DataTable = New
 DataTable("table")
    Dim column As DataColumn = New
 DataColumn("col1")
    column.Unique = True
    table.Columns.Add(column)
    dataSet.Tables.Add(table)
    Console.WriteLine("constraints.count: " _
        & table.Constraints.Count)

    ' add five rows.
    Dim row As DataRow
    Dim i As Integer
    For i = 0 To 4
       row = table.NewRow()
       row("col1") = i
       table.Rows.Add(row)
    Next
    table.AcceptChanges()
     
    dataSet.EnforceConstraints = False
    ' Change the values of all rows to 1.
    Dim thisRow As DataRow
    For Each thisRow In
 table.rows
       thisRow("col1") = 1
    Next
 
    Try
        dataSet.EnforceConstraints = True
    Catch e As System.Data.ConstraintException
        ' Process exception and return.
        Console.WriteLine("Exception of type {0} occurred.",
 _
            e.GetType().ToString())
    End Try
End Sub

C#

private void DemonstrateEnforceConstraints()
{
    // Create a DataSet with one table, one column and 
    // a UniqueConstraint.
    DataSet dataSet= new DataSet("dataSet");
    DataTable table = new DataTable("table");
    DataColumn column = new DataColumn("col1");

    // A UniqueConstraint is added when the Unique 
    // property is true.
    column.Unique=true;
    table.Columns.Add(column);
    dataSet.Tables.Add(table);
    Console.WriteLine("constraints.count: " + 
        table.Constraints.Count);

    // add five rows.
    DataRow row ;
    for(int i=0;i<5;i++)
    {
        row = table.NewRow();
        row["col1"] = i;
        table.Rows.Add(row);
    }
    table.AcceptChanges();

    dataSet.EnforceConstraints=false;
    // Change the values of all rows to 1.
    foreach(DataRow thisRow in table.Rows)
    {
        thisRow["col1"]=1;
        //Console.WriteLine("\table" + thisRow[0]);
    }
    try
    {
        dataSet.EnforceConstraints=true;
    }
    catch(System.Data.ConstraintException e)
    {
        // Process exception and return.
        Console.WriteLine("Exception of type {0} occurred.", 
            e.GetType());
    }
}

プラットフォーム

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

参照

関連項目
DataSet クラス
DataSet メンバ
System.Data 名前空間
その他の技術情報
ADO.NET での DataSet の使用