ObjectDataSourceView.DeleteMethod Свойство

Определение

Получает или задает имя метода или функции, вызываемых объектом ObjectDataSourceView для удаления данных.Gets or sets the name of the method or function that the ObjectDataSourceView object invokes to delete data.

public:
 property System::String ^ DeleteMethod { System::String ^ get(); void set(System::String ^ value); };
public string DeleteMethod { get; set; }
member this.DeleteMethod : string with get, set
Public Property DeleteMethod As String

Значение свойства

Строка, представляющая имя метода или функции, используемых объектом ObjectDataSourceView для удаления данных.A string that represents the name of the method or function that the ObjectDataSourceView uses to delete data. Значение по умолчанию — пустая строка ("").The default is an empty string ("").

Примеры

В следующем примере кода показано, как использовать ObjectDataSource элемент управления с бизнес-объектом GridView и элементом управления для удаления данных.The following code example demonstrates how to use an ObjectDataSource control with a business object and a GridView control to delete data. Изначально отображает набор всех сотрудников с помощью метода, указанного SelectMethod свойством для EmployeeLogic получения данных из объекта. GridViewThe GridView initially displays a set of all employees, using the method that is specified by the SelectMethod property to retrieve the data from the EmployeeLogic object. Так как trueсвойствоимеетзначение, GridView элемент управления автоматически отображает кнопку Delete. AutoGenerateDeleteButtonBecause the AutoGenerateDeleteButton property is set to true, the GridView control automatically displays a Delete button.

Если нажать кнопку Удалить Delete , операция выполняется с помощью метода, указанного DeleteMethod свойством, и DeleteParameters всех параметров, указанных в коллекции.If you click the Delete button, the Delete operation is performed using the method that is specified by the DeleteMethod property and any parameters that are specified in the DeleteParameters collection. В этом примере кода также выполняются некоторые этапы предварительной обработки и последующей обработки.In this code example, some preprocessing and post-processing steps are also performed. NorthwindEmployeeDeleted Delete Deleted Delete Делегат вызывается для Deleting обработчика события до выполнения операции, а делегат вызывается для того, чтобы обрабатывал событие после завершения операции, NorthwindEmployeeDeleting выполнение обработки исключений.The NorthwindEmployeeDeleting delegate is called to handle the Deleting event before the Delete operation is performed, and the NorthwindEmployeeDeleted delegate is called to handle the Deleted event after the Delete operation has completed, to perform an exception handling. В этом примере, если NorthwindDataException создается исключение, оно обрабатывается этим делегатом.In this example, if a NorthwindDataException is thrown, it is handled by this delegate.

Чтобы проверить реализацию EmployeeLogic бизнес-объекта среднего уровня, используемого в этом примере кода, см. раздел ObjectDataSourceStatusEventArgs.To examine the implementation of the EmployeeLogic middle-tier business object that this code example uses, see ObjectDataSourceStatusEventArgs.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ Import namespace="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
private void NorthwindEmployeeDeleting(object source, ObjectDataSourceMethodEventArgs e)
{
  // The GridView passes the ID of the employee
  // to be deleted. However, the buisiness object, EmployeeLogic,
  // requires a NorthwindEmployee parameter, named "ne". Create
  // it now and add it to the parameters collection.
  IDictionary paramsFromPage = e.InputParameters;
  if (paramsFromPage["EmpID"] != null) {
    NorthwindEmployee ne
      = new NorthwindEmployee( Int32.Parse(paramsFromPage["EmpID"].ToString()));
    // Remove the old EmpID parameter.
    paramsFromPage.Clear();
    paramsFromPage.Add("ne", ne);
  }
}

private void NorthwindEmployeeDeleted(object source, ObjectDataSourceStatusEventArgs e)
{
  // Handle the Exception if it is a NorthwindDataException
  if (e.Exception != null)
  {

    // Handle the specific exception type. The ObjectDataSource wraps
    // any Exceptions in a TargetInvokationException wrapper, so
    // check the InnerException property for expected Exception types.
    if (e.Exception.InnerException is NorthwindDataException)
    {
      Label1.Text = e.Exception.InnerException.Message;
      // Because the exception is handled, there is
      // no reason to throw it.
      e.ExceptionHandled = true;
    }
  }
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1"
          autogeneratedeletebutton="true"
          autogeneratecolumns="false"
          datakeynames="EmpID">
          <columns>
            <asp:boundfield headertext="EmpID" datafield="EmpID" />
            <asp:boundfield headertext="First Name" datafield="FirstName" />
            <asp:boundfield headertext="Last Name" datafield="LastName" />
          </columns>
        </asp:gridview>

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          deletemethod="DeleteEmployee"
          ondeleting="NorthwindEmployeeDeleting"
          ondeleted="NorthwindEmployeeDeleted"
          typename="Samples.AspNet.CS.EmployeeLogic">
          <deleteparameters>
            <asp:parameter name="EmpID" type="Int32" />
          </deleteparameters>
        </asp:objectdatasource>

        <asp:label id="Label1" runat="server" />

    </form>
  </body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ Import namespace="Samples.AspNet.VB" %>
<%@ Page language="vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
' Called before a Delete operation.
    Private Sub NorthwindEmployeeDeleting(ByVal source As Object, ByVal e As ObjectDataSourceMethodEventArgs)

        ' The GridView passes the ID of the employee
        ' to be deleted. However, the business object, EmployeeLogic,
        ' requires a NorthwindEmployee parameter, named "ne". Create
        ' it now and add it to the parameters collection.
        Dim paramsFromPage As IDictionary = e.InputParameters
  
        If Not paramsFromPage("EmpID") Is Nothing Then
    
            Dim ne As New NorthwindEmployee(paramsFromPage("EmpID").ToString())
            ' Remove the old EmpID parameter.
            paramsFromPage.Clear()
            paramsFromPage.Add("ne", ne)
    
    
        End If
    End Sub ' NorthwindEmployeeDeleting

    ' Called after a Delete operation.
    Private Sub NorthwindEmployeeDeleted(ByVal source As Object, ByVal e As ObjectDataSourceStatusEventArgs)
        ' Handle the Exception if it is a NorthwindDataException.
        If Not e.Exception Is Nothing Then

            ' Handle the specific exception type. The ObjectDataSource wraps
            ' any Exceptions in a TargetInvokationException wrapper, so
            ' check the InnerException property for the expected Exception types.
            If e.Exception.InnerException.GetType().Equals(GetType(NorthwindDataException)) Then

                Label1.Text = e.Exception.InnerException.Message
                ' Because the exception is handled, there is
                ' no reason to throw it.
                e.ExceptionHandled = True
      
            End If
        End If
    End Sub ' NorthwindEmployeeDeleted
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - VB Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1"
          autogeneratedeletebutton="true"
          autogeneratecolumns="false"
          datakeynames="EmpID">
          <columns>
            <asp:boundfield headertext="EmpID" datafield="EmpID" />
            <asp:boundfield headertext="First Name" datafield="FirstName" />
            <asp:boundfield headertext="Last Name" datafield="LastName" />
          </columns>
        </asp:gridview>

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          deletemethod="DeleteEmployee"
          ondeleting="NorthwindEmployeeDeleting"
          ondeleted="NorthwindEmployeeDeleted"
          typename="Samples.AspNet.VB.EmployeeLogic">
          <deleteparameters>
            <asp:parameter name="EmpID" type="Int32" />
          </deleteparameters>
        </asp:objectdatasource>

        <asp:label id="Label1" runat="server" />

    </form>
  </body>
</html>

Комментарии

Метод, идентифицируемый DeleteMethod свойством, может быть методом экземпляра static или методом (Shared в Visual Basic).The method that is identified by the DeleteMethod property can be an instance method or a static (Shared in Visual Basic) method. Если это метод экземпляра, бизнес-объект создается и уничтожается каждый раз, когда вызывается метод, заданный DeleteMethod свойством.If it is an instance method, the business object is created and destroyed each time the method specified by the DeleteMethod property is called. Вы можете ObjectCreated обойти событие, чтобы работать с бизнес-объектом до вызова метода, указанного DeleteMethod свойством.You can handle the ObjectCreated event to work with the business object before the method specified by the DeleteMethod property is called. Можно также выполнить обработку ObjectDisposing события, возникающего после вызова метода, заданного DeleteMethod свойством.You can also handle the ObjectDisposing event that is raised after the method specified by the DeleteMethod property is called. Если метод является static методом (Shared в Visual Basic), бизнес-объект никогда не создается, и эти события не могут быть обработаны.If the method is a static (Shared in Visual Basic) method, the business object is never created and you cannot handle these events.

Если бизнес-объект, с ObjectDataSource которым работает элемент управления, реализует несколько методов или функций с одним и тем же именем (перегрузки метода), элемент управления источника данных пытается вызвать правильное значение в соответствии с набором условий, включая параметры. DeleteParameters в коллекции.If the business object that the ObjectDataSource control works with implements more than one method or function with the same name (method overloads), the data source control attempts to invoke the correct one according to a set of conditions, including the parameters in the DeleteParameters collection. Если параметры в DeleteParameters коллекции не соответствуют DeleteMethod параметрам сигнатуры метода, источник данных создает исключение.If the parameters in the DeleteParameters collection do not match those of the DeleteMethod method signature, the data source throws an exception.

Значение DeleteMethod свойства хранится в состоянии представления.The value of the DeleteMethod property is stored in view state.

Для получения дополнительной информации см. DeleteMethod.For more information, see DeleteMethod.

Применяется к

Дополнительно