System.Web.UI.WebControls.ObjectDataSourceDisposingEventArgs Class

Provides data for the ObjectDataSource.ObjectDisposing event of the System.Web.UI.WebControls.ObjectDataSource control.

See Also: ObjectDataSourceDisposingEventArgs Members

Syntax

public class ObjectDataSourceDisposingEventArgs : System.ComponentModel.CancelEventArgs

Remarks

The System.Web.UI.WebControls.ObjectDataSourceDisposingEventArgs class is used in the ObjectDataSourceView.OnObjectDisposing(ObjectDataSourceDisposingEventArgs) method to provide access to the business object instance after any data operations that are using the System.Web.UI.WebControls.ObjectDataSource control and business object are performed, but before the business object is destroyed. The business object is accessed using the ObjectDataSourceDisposingEventArgs.ObjectInstance property. By adding a delegate to handle the ObjectDataSource.ObjectDisposing event, you can access any publicly exposed members of the business object to perform any final work or clean up.

The ObjectDataSourceView.OnObjectDisposing(ObjectDataSourceDisposingEventArgs) method is not called by the System.Web.UI.WebControls.ObjectDataSource control, if the method that performs data operations is a static method. No business object instance is created when the method is static.

The System.Web.UI.WebControls.ObjectDataSource control exposes many events that you can handle to work with the underlying business object at various times in its lifecycle. The following table lists the events and the associated EventArgs classes and event handler delegates.

ObjectDataSource.ObjectCreating.

Occurs immediately before the instance of the business object is created.

System.Web.UI.WebControls.ObjectDataSourceEventArgs

System.Web.UI.WebControls.ObjectDataSourceObjectEventHandler

ObjectDataSource.ObjectCreated.

Occurs immediately after the instance of the business object is created.

System.Web.UI.WebControls.ObjectDataSourceEventArgs

System.Web.UI.WebControls.ObjectDataSourceObjectEventHandler

ObjectDataSource.Selecting.

Occurs before the data is retrieved.

System.Web.UI.WebControls.ObjectDataSourceSelectingEventArgs

System.Web.UI.WebControls.ObjectDataSourceSelectingEventHandler

ObjectDataSource.Inserting, ObjectDataSource.Updating, and ObjectDataSource.Deleting.

Occur before an insert, update, or delete operation is performed.

System.Web.UI.WebControls.ObjectDataSourceMethodEventArgs

System.Web.UI.WebControls.ObjectDataSourceMethodEventHandler

ObjectDataSource.Selected

Occurs after the data is retrieved.

System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs

System.Web.UI.WebControls.ObjectDataSourceStatusEventHandler

ObjectDataSource.Inserted, ObjectDataSource.Updated, and ObjectDataSource.Deleted.

Occur after the insert, update, or delete operation is completed.

System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs

System.Web.UI.WebControls.ObjectDataSourceStatusEventHandler

ObjectDataSource.ObjectDisposing.

Occurs before a business object is destroyed.

System.Web.UI.WebControls.ObjectDataSourceDisposingEventArgs

System.Web.UI.WebControls.ObjectDataSourceDisposingEventHandler

Requirements

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0