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

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

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. GridViewИзначально отображает набор всех сотрудников с помощью метода, указанного SelectMethod свойством для получения данных из EmployeeLogic объекта.The 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. Так как AutoGenerateDeleteButton свойство имеет значение true , GridView элемент управления автоматически отображает кнопку Delete .Because 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. NorthwindEmployeeDeletingДелегат вызывается для обработки Deleting события до выполнения Delete операции, а NorthwindEmployeeDeleted делегат вызывается для обработки Deleted события после Delete завершения операции, чтобы выполнить обработку исключений.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.

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

См. также раздел