DataTable.ColumnChanging イベント

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

DataTable.ColumnChanging イベント

DataRow 内の指定した DataColumn の値が変更されているときに発生します。

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

Visual Basic (宣言)

Public Event ColumnChanging As
 DataColumnChangeEventHandler

Visual Basic (使用法)

Dim instance As DataTable
Dim handler As DataColumnChangeEventHandler

AddHandler instance.ColumnChanging, handler

C#

public event DataColumnChangeEventHandler ColumnChanging

C++

public:
event DataColumnChangeEventHandler^ ColumnChanging {
    void add (DataColumnChangeEventHandler^ value);
    void remove (DataColumnChangeEventHandler^ value);
}

J#

/** @event */
public void add_ColumnChanging (DataColumnChangeEventHandler
 value)

/** @event */
public void remove_ColumnChanging (DataColumnChangeEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

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

使用例

Visual Basic

Private Shared Sub DataTableColumnChanging()
    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 ColumnChanging event handler for the table.
    AddHandler custTable.ColumnChanging, New
 _
        DataColumnChangeEventHandler(AddressOf Column_Changing
 )

    ' 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_Changing(sender
 As Object, _
    e As DataColumnChangeEventArgs)
    Console.WriteLine( _
        "Column_Changing Event: name={0}; Column={1}; proposed
 name={2}", _
        e.Row("name"), e.Column.ColumnName, e.ProposedValue)
 
End Sub

C#

private static void DataTableColumnChanging()
{
    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 ColumnChanging event handler for the table.
    custTable.ColumnChanging += new 
        DataColumnChangeEventHandler(Column_Changing );


    // 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_Changing(object
 sender, 
    DataColumnChangeEventArgs e )
{
    Console.WriteLine(
        "Column_Changing Event: name={0}; Column={1}; proposed name={2}",
 
        e.Row["name"], e.Column.ColumnName, e.ProposedValue );
}

プラットフォーム

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

参照

関連項目
DataTable クラス
DataTable メンバ
System.Data 名前空間
その他の技術情報
DataTable の作成と使用