DataTable 이벤트 처리
DataTable 개체는 애플리케이션에서 처리할 수 있는 일련의 이벤트를 제공합니다. 다음 표에서는 DataTable
이벤트에 대해 설명합니다.
이벤트 | 설명 |
---|---|
Initialized | EndInit의 DataTable 메서드가 호출된 후에 발생합니다. 이 이벤트는 기본적으로 디자인 타임 시나리오를 지원하는 데 사용됩니다. |
ColumnChanged | DataColumn에서 값이 성공적으로 변경된 후에 발생합니다. |
ColumnChanging | DataColumn 의 값이 제출될 때 발생합니다. |
RowChanged | DataColumn 값 또는 RowState에 있는 DataRow의 DataTable 가 성공적으로 변경된 후에 발생합니다. |
RowChanging | DataColumn 값 또는 RowState 에 있는 DataRow 의 DataTable 에 대한 변경된 값이 제출될 때 발생합니다. |
RowDeleted | DataRow 의 DataTable 가 Deleted 로 표시된 후에 발생합니다. |
RowDeleting | DataRow 의 DataTable 가 Deleted 로 표시되기 전에 발생합니다. |
TableCleared | Clear의 DataTable 메서드 호출을 통해 모든 DataRow 가 성공적으로 삭제된 후에 발생합니다. |
TableClearing | Clear 메서드가 호출된 후 Clear 작업이 시작되기 전에 발생합니다. |
TableNewRow | DataRow 의 NewRow 메서드 호출을 통해 새 DataTable 가 만들어진 후에 발생합니다. |
Disposed | DataTable 이 Disposed 가 될 때 발생합니다. MarshalByValueComponent에서 상속됩니다. |
참고 항목
행을 추가하거나 삭제하는 대부분의 작업은 ColumnChanged
및 ColumnChanging
이벤트를 발생시키지 않습니다. 그러나 ReadXml
메서드는 ColumnChanged
및 ColumnChanging
이벤트를 발생시킵니다. 단, 읽고 있는 XML 문서가 XmlReadMode
이고 DiffGram
가 Auto
또는 DiffGram
로 설정되어 있는 경우는 예외입니다.
Warning
DataSet
이벤트가 발생한 RowChanged
에서 데이터를 수정하면 데이터가 손상될 수 있습니다. 이와 같은 데이터 손상이 발생하면 예외가 발생하지 않습니다.
추가 관련 이벤트
Constraints 속성은 ConstraintCollection 인스턴스를 포함합니다. ConstraintCollection 클래스는 CollectionChanged 이벤트를 노출합니다. 이 이벤트는 ConstraintCollection
에서 제약 조건이 추가되거나 수정되거나 제거될 때 발생합니다.
Columns 속성은 DataColumnCollection 인스턴스를 포함합니다. DataColumnCollection
클래스는 CollectionChanged 이벤트를 노출합니다. 이 이벤트는 DataColumn
에서 DataColumnCollection
이 추가되거나 수정되거나 제거될 때 발생합니다. 열의 이름, 형식, 식 또는 위치 등이 변경되어 열이 수정되면 이 이벤트가 발생합니다.
Tables의 DataSet 속성은 DataTableCollection 인스턴스를 포함합니다. DataTableCollection
클래스는 CollectionChanged
와 CollectionChanging
이벤트를 모두 노출합니다. 이 두 이벤트는 DataTable
에서 DataSet
이 추가되거나 제거될 때 발생합니다.
DataRows
가 변경되는 경우에도 관련 DataView의 이벤트가 발생합니다. DataView
클래스는 ListChanged 값이 변경되거나 뷰의 구성 또는 정렬 순서가 변경될 때 발생하는 DataColumn
이벤트를 노출합니다. DataRowView 클래스는 관련 PropertyChanged 값이 변경될 때 발생하는 DataColumn
이벤트를 노출합니다.
작업 순서
다음은 DataRow
가 추가, 수정 또는 삭제되는 경우의 작업 순서입니다.
제안된 레코드를 만들고 변경 내용을 적용합니다.
식이 아닌 열의 제약 조건을 검사합니다.
가능한 경우
RowChanging
또는RowDeleting
이벤트를 발생시킵니다.제안된 레코드를 현재 레코드로 설정합니다.
관련된 인덱스를 업데이트합니다.
관련
ListChanged
개체에 대해DataView
이벤트를 발생시키고, 관련PropertyChanged
개체에 대해DataRowView
이벤트를 발생시킵니다.모든 식 열을 계산합니다. 단, 열의 제약 조건 검사는 지금 수행하지 않습니다.
식 열 계산 결과에 영향을 받은 관련
ListChanged
개체에 대해DataView
이벤트를 발생시키고, 관련PropertyChanged
개체에 대해DataRowView
이벤트를 발생시킵니다.가능한 경우
RowChanged
또는RowDeleted
이벤트를 발생시킵니다.식 열의 제약 조건을 검사합니다.
참고 항목
식 열이 변경되는 경우에는 DataTable
이벤트가 발생하지 않습니다. 식 열이 변경되면 DataView
및 DataRowView
이벤트만 발생합니다. 식 열은 다른 여러 열에 종속될 수 있으므로 단일 DataRow
작업 중 여러 번 계산될 수 있습니다. 식을 계산할 때마다 이벤트가 발생합니다. 또한 식 열이 변경되는 경우 동일한 식 열에 대한 여러 이벤트를 포함하여 단일 DataRow
작업에서 여러 ListChanged
및 PropertyChanged
이벤트가 발생할 수 있습니다.
Warning
NullReferenceException 이벤트 처리기 내에서 RowChanged
을 throw하지 마세요. NullReferenceException이 RowChanged
의 DataTable
이벤트 내에서 throw되면 DataTable
이 손상됩니다.
예시
다음 예제에서는 RowChanged
, RowChanging
, RowDeleted
, RowDeleting
, ColumnChanged
, ColumnChanging
, TableNewRow
, TableCleared
및 TableClearing
이벤트에 대한 이벤트 처리기를 만드는 방법을 보여 줍니다. 각 이벤트 처리기는 이벤트가 발생하면 콘솔 창에 해당 출력을 표시합니다.
static void DataTableEvents()
{
DataTable table = new("Customers");
// Add two columns, id and name.
table.Columns.Add("id", typeof(int));
table.Columns.Add("name", typeof(string));
// Set the primary key.
table.Columns["id"].Unique = true;
table.PrimaryKey = new DataColumn[] { table.Columns["id"] };
// Add a RowChanged event handler.
table.RowChanged += Row_Changed;
// Add a RowChanging event handler.
table.RowChanging += Row_Changing;
// Add a RowDeleted event handler.
table.RowDeleted += Row_Deleted;
// Add a RowDeleting event handler.
table.RowDeleting += Row_Deleting;
// Add a ColumnChanged event handler.
table.ColumnChanged +=
Column_Changed;
// Add a ColumnChanging event handler.
table.ColumnChanging +=
Column_Changing;
// Add a TableNewRow event handler.
table.TableNewRow +=
Table_NewRow;
// Add a TableCleared event handler.
table.TableCleared +=
Table_Cleared;
// Add a TableClearing event handler.
table.TableClearing +=
Table_Clearing;
// Add a customer.
DataRow row = table.NewRow();
row["id"] = 1;
row["name"] = "Customer1";
table.Rows.Add(row);
table.AcceptChanges();
// Change the customer name.
table.Rows[0]["name"] = "ChangedCustomer1";
// Delete the row.
table.Rows[0].Delete();
// Clear the table.
table.Clear();
}
static void Row_Changed(object sender, DataRowChangeEventArgs e) =>
Console.WriteLine("Row_Changed Event: name={0}; action={1}",
e.Row["name"], e.Action);
static void Row_Changing(object sender, DataRowChangeEventArgs e) =>
Console.WriteLine("Row_Changing Event: name={0}; action={1}",
e.Row["name"], e.Action);
static void Row_Deleted(object sender, DataRowChangeEventArgs e) =>
Console.WriteLine("Row_Deleted Event: name={0}; action={1}",
e.Row["name", DataRowVersion.Original], e.Action);
static void Row_Deleting(object sender,
DataRowChangeEventArgs e) =>
Console.WriteLine("Row_Deleting Event: name={0}; action={1}",
e.Row["name"], e.Action);
static void Column_Changed(object sender, DataColumnChangeEventArgs e) =>
Console.WriteLine("Column_Changed Event: ColumnName={0}; RowState={1}",
e.Column.ColumnName, e.Row.RowState);
static void Column_Changing(object sender, DataColumnChangeEventArgs e) =>
Console.WriteLine("Column_Changing Event: ColumnName={0}; RowState={1}",
e.Column.ColumnName, e.Row.RowState);
static void Table_NewRow(object sender,
DataTableNewRowEventArgs e) =>
Console.WriteLine("Table_NewRow Event: RowState={0}",
e.Row.RowState.ToString());
static void Table_Cleared(object sender, DataTableClearEventArgs e) =>
Console.WriteLine("Table_Cleared Event: TableName={0}; Rows={1}",
e.TableName, e.Table.Rows.Count.ToString());
static void Table_Clearing(object sender, DataTableClearEventArgs e) =>
Console.WriteLine("Table_Clearing Event: TableName={0}; Rows={1}",
e.TableName, e.Table.Rows.Count.ToString());
Private Sub DataTableEvents()
Dim table As New DataTable("Customers")
' Add two columns, id and name.
table.Columns.Add("id", Type.GetType("System.Int32"))
table.Columns.Add("name", Type.GetType("System.String"))
' Set the primary key.
table.Columns("id").Unique = True
table.PrimaryKey = New DataColumn() {table.Columns("id")}
' Add a RowChanged event handler.
AddHandler table.RowChanged, _
New DataRowChangeEventHandler(AddressOf Row_Changed)
' Add a RowChanging event handler.
AddHandler table.RowChanging, _
New DataRowChangeEventHandler(AddressOf Row_Changing)
' Add a RowDeleted event handler.
AddHandler table.RowDeleted, New _
DataRowChangeEventHandler(AddressOf Row_Deleted)
' Add a RowDeleting event handler.
AddHandler table.RowDeleting, New _
DataRowChangeEventHandler(AddressOf Row_Deleting)
' Add a ColumnChanged event handler.
AddHandler table.ColumnChanged, _
New DataColumnChangeEventHandler(AddressOf Column_Changed)
' Add a ColumnChanging event handler for the table.
AddHandler table.ColumnChanging, New _
DataColumnChangeEventHandler(AddressOf Column_Changing)
' Add a TableNewRow event handler.
AddHandler table.TableNewRow, New _
DataTableNewRowEventHandler(AddressOf Table_NewRow)
' Add a TableCleared event handler.
AddHandler table.TableCleared, New _
DataTableClearEventHandler(AddressOf Table_Cleared)
' Add a TableClearing event handler.
AddHandler table.TableClearing, New _
DataTableClearEventHandler(AddressOf Table_Clearing)
' Add a customer.
Dim row As DataRow = table.NewRow()
row("id") = 1
row("name") = "Customer1"
table.Rows.Add(row)
table.AcceptChanges()
' Change the customer name.
table.Rows(0).Item("name") = "ChangedCustomer1"
' Delete the row.
table.Rows(0).Delete()
' Clear the table.
table.Clear()
End Sub
Private Sub Row_Changed(ByVal sender As Object, _
ByVal e As DataRowChangeEventArgs)
Console.WriteLine("Row_Changed Event: name={0}; action={1}", _
e.Row("name"), e.Action)
End Sub
Private Sub Row_Changing(ByVal sender As Object, _
ByVal e As DataRowChangeEventArgs)
Console.WriteLine("Row_Changing Event: name={0}; action={1}", _
e.Row("name"), e.Action)
End Sub
Private Sub Row_Deleted(ByVal sender As Object, _
ByVal e As DataRowChangeEventArgs)
Console.WriteLine("Row_Deleted Event: name={0}; action={1}", _
e.Row("name", DataRowVersion.Original), e.Action)
End Sub
Private Sub Row_Deleting(ByVal sender As Object, _
ByVal e As DataRowChangeEventArgs)
Console.WriteLine("Row_Deleting Event: name={0}; action={1}", _
e.Row("name"), e.Action)
End Sub
Private Sub Column_Changed(ByVal sender As Object, _
ByVal e As DataColumnChangeEventArgs)
Console.WriteLine("Column_Changed Event: ColumnName={0}; RowState={1}", _
e.Column.ColumnName, e.Row.RowState)
End Sub
Private Sub Column_Changing(ByVal sender As Object, _
ByVal e As DataColumnChangeEventArgs)
Console.WriteLine("Column_Changing Event: ColumnName={0}; RowState={1}", _
e.Column.ColumnName, e.Row.RowState)
End Sub
Private Sub Table_NewRow(ByVal sender As Object, _
ByVal e As DataTableNewRowEventArgs)
Console.WriteLine("Table_NewRow Event: RowState={0}", _
e.Row.RowState.ToString())
End Sub
Private Sub Table_Cleared(ByVal sender As Object, _
ByVal e As DataTableClearEventArgs)
Console.WriteLine("Table_Cleared Event: TableName={0}; Rows={1}", _
e.TableName, e.Table.Rows.Count.ToString())
End Sub
Private Sub Table_Clearing(ByVal sender As Object, _
ByVal e As DataTableClearEventArgs)
Console.WriteLine("Table_Clearing Event: TableName={0}; Rows={1}", _
e.TableName, e.Table.Rows.Count.ToString())
End Sub