DataTable.ColumnChanged イベント

DataRow 内の指定した DataColumn の値が変更された後に発生します。

Public Event ColumnChanged As DataColumnChangeEventHandler
[C#]
public event DataColumnChangeEventHandler ColumnChanged;
[C++]
public: __event DataColumnChangeEventHandler* ColumnChanged;

[JScript] JScript では、このクラスで定義されているイベントを処理できます。ただし、独自に定義することはできません。

イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、DataColumnChangeEventArgs 型の引数を受け取りました。次の DataColumnChangeEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ	説明
Column	値が変化する DataColumn を取得します。
ProposedValue	列の提示された新しい値を取得または設定します。
Row	値が変化する列の DataRow を取得します。

解説

詳細については、「 DataTable イベントの使用 」を参照してください。

使用例

 
Private Shared Sub DataTableColumnChanged()
    Dim custTable As DataTable = New DataTable("Customers")
    ' add columns
    custTable.Columns.Add( "id", Type.GetType("System.Int32") )
    custTable.Columns.Add( "name", Type.GetType("System.String") )
    custTable.Columns.Add( "address", Type.GetType("System.String") )

    ' set PrimaryKey
    custTable.Columns( "id" ).Unique = true
    custTable.PrimaryKey = New DataColumn() { custTable.Columns("id") }

    ' add a ColumnChanged event handler for the table.
    AddHandler custTable.ColumnChanged, New DataColumnChangeEventHandler( AddressOf Column_Changed )


    ' add ten rows
    Dim id As Integer
    For id = 1 To 10
        custTable.Rows.Add( _
            New Object() { id, string.Format("customer{0}", id), string.Format("address{0}", id) } )
    Next
    
    custTable.AcceptChanges()

    ' change the name column in all the rows
    Dim row As DataRow
    For Each row In custTable.Rows 
        row("name") = string.Format( "vip{0}", row("id") )
    Next

End Sub

Private Shared Sub Column_Changed(sender As Object, e As DataColumnChangeEventArgs)
    Console.WriteLine( "Column_Changed Event: name={0}; Column={1}; original name={2}", _
        e.Row("name"), e.Column.ColumnName, e.Row("name", DataRowVersion.Original) )
End Sub

[C#] 
private static void DataTableColumnChanged()
{
    DataTable custTable = new DataTable("Customers");
    // add columns
    custTable.Columns.Add( "id", typeof(int) );
    custTable.Columns.Add( "name", typeof(string) );
    custTable.Columns.Add( "address", typeof(string) );

    // set PrimaryKey
    custTable.Columns[ "id" ].Unique = true;
    custTable.PrimaryKey = new DataColumn[] { custTable.Columns["id"] };

    // add a ColumnChanged event handler for the table.
    custTable.ColumnChanged += new DataColumnChangeEventHandler( Column_Changed );


    // add ten rows
    for( int id=1; id<=10; id++ )
    {
        custTable.Rows.Add( 
            new object[] { id, string.Format("customer{0}", id), string.Format("address{0}", id) } );
    }
    
    custTable.AcceptChanges();

    // change the name column in all the rows
    foreach( DataRow row in custTable.Rows )
    {
        row["name"] = string.Format( "vip{0}", row["id"] );
    }

}

private static void Column_Changed( object sender, DataColumnChangeEventArgs e )
{
    Console.WriteLine( "Column_Changed Event: name={0}; Column={1}; original name={2}", 
        e.Row["name"], e.Column.ColumnName, e.Row["name", DataRowVersion.Original] );
}

[C++] 

public:
    static void DataTableColumnChanged() {
        DataTable* custTable = new DataTable(S"Customers");
        // add columns
        custTable->Columns->Add(S"id", __typeof(int));
        custTable->Columns->Add(S"name", __typeof(String));
        custTable->Columns->Add(S"address", __typeof(String));

        // set PrimaryKey
        custTable->Columns->Item[ S"id" ]->Unique = true;
        DataColumn* c[] = { custTable->Columns->Item[S"id"] };
        custTable->PrimaryKey = c;

        // add a ColumnChanged event handler for the table.
        custTable->ColumnChanged += new DataColumnChangeEventHandler(0,Column_Changed);

        // add ten rows
        for (int id=1; id<=10; id++) {

            Object* myArray[] =    {
                __box(id), 
                String::Format(S"customer {0}", __box(id)), 
                String::Format(S"address {0}", __box(id)) 
            };

            custTable->Rows->Add( myArray );
        }

        custTable->AcceptChanges();

        // change the name column in all the rows
        IEnumerator* myEnum = custTable->Rows->GetEnumerator();
        while (myEnum->MoveNext()) {
            DataRow* row = __try_cast<DataRow*>(myEnum->Current);

            row->Item[S"name"] = String::Format(S"vip {0}", row->Item[S"id"]);
        }

    };

public:
    static void Column_Changed(Object* sender, DataColumnChangeEventArgs* e) {
        Console::WriteLine(S"Column_Changed Event: name= {0}; Column= {1}; original name= {2}", 
            e->Row->Item[S"name"], e->Column->ColumnName, e->Row->Item[S"name", DataRowVersion::Original]);
    };

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

必要条件

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

参照

DataTable クラス | DataTable メンバ | System.Data 名前空間