Export (0) Print
Expand All

ObjectDataSource.Delete Method

Performs a delete operation by calling the method that is identified by the DeleteMethod property with any parameters that are in the DeleteParameters collection.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public int Delete()

Return Value

Type: System.Int32
A value that represents the number of rows deleted from the underlying data storage, if the AffectedRows property of the ObjectDataSourceStatusEventArgs is set in the Deleted event; otherwise, -1.

Before the Delete operation is performed, the OnDeleting method is called to raise the Deleting event. You can handle the Deleting event to examine the values of the parameters and to perform any preprocessing before a Delete operation. To perform a delete operation, the ObjectDataSourceView object uses reflection to create an instance of the object that is identified by the TypeName property. It then calls the method that is identified by the DeleteMethod property, using any associated DeleteParameters properties. If the deletion parameters come from an associated data-bound control, the name of the parameters is created according to the OldValuesParameterFormatString property. After the Delete operation completes, the OnDeleted method is called to raise the Deleted event. You can handle the Deleted event to examine any return values, output parameters, and exceptions, and to perform any post-processing.

The Delete method delegates to the Delete method of the ObjectDataSourceView object that is associated with the ObjectDataSource control.

Data-Bound Controls

When the ObjectDataSource control is associated with a data-bound control, such as the GridView control, it is not necessary to call the Delete method from page code. The Delete method is invoked directly by the data-bound control instead.

For more information about parameter merging, object lifetime, and method resolution, see DeleteMethod.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0

Community Additions

ADD
Show:
© 2014 Microsoft