DataTable.ColumnChanging-Ereignis
Tritt ein, wenn ein Wert für die angegebene DataColumn in einer DataRow geändert wird.
Namespace: System.Data
Assembly: System.Data (in system.data.dll)
Syntax
'Declaration
Public Event ColumnChanging As DataColumnChangeEventHandler
'Usage
Dim instance As DataTable
Dim handler As DataColumnChangeEventHandler
AddHandler instance.ColumnChanging, handler
public event DataColumnChangeEventHandler ColumnChanging
public:
event DataColumnChangeEventHandler^ ColumnChanging {
void add (DataColumnChangeEventHandler^ value);
void remove (DataColumnChangeEventHandler^ value);
}
/** @event */
public void add_ColumnChanging (DataColumnChangeEventHandler value)
/** @event */
public void remove_ColumnChanging (DataColumnChangeEventHandler value)
JScript unterstützt die Verwendung von Ereignissen, aber nicht die Deklaration von neuen Ereignissen.
Hinweise
Weitere Informationen finden Sie unter Arbeiten mit DataTable-Ereignissen.
Beispiel
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
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 );
}
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
DataTable-Klasse
DataTable-Member
System.Data-Namespace