ObjectDataSourceView.DeleteMethod Propriété

Définition

Obtient ou définit le nom de la méthode ou de la fonction que l'objet ObjectDataSourceView appelle pour supprimer des données.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

Valeur de propriété

Chaîne qui représente le nom de la méthode ou de la fonction que ObjectDataSourceView utilise pour supprimer des données.A string that represents the name of the method or function that the ObjectDataSourceView uses to delete data. La valeur par défaut est une chaîne vide ("").The default is an empty string ("").

Exemples

L’exemple de code suivant montre comment utiliser un ObjectDataSource contrôle avec un objet métier et un GridView contrôle pour supprimer des données.The following code example demonstrates how to use an ObjectDataSource control with a business object and a GridView control to delete data. La GridView première affiche un ensemble de tous les employés, à l’aide de la méthode spécifiée SelectMethod par la propriété pour récupérer les données EmployeeLogic de l’objet.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. Étant donné AutoGenerateDeleteButton que la propriété a truela valeur GridView , le contrôle affiche automatiquement un bouton supprimer .Because the AutoGenerateDeleteButton property is set to true, the GridView control automatically displays a Delete button.

Si vous cliquez sur le bouton supprimer , Delete l’opération est effectuée à l’aide de la méthode spécifiée DeleteMethod par la propriété et de tous les paramètres spécifiés dans la DeleteParameters collection.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. Dans cet exemple de code, certaines étapes de prétraitement et de suivi sont également effectuées.In this code example, some preprocessing and post-processing steps are also performed. Le NorthwindEmployeeDeleting délégué est appelé pour gérer l' Deleting événement avant l' Delete exécution de l’opération, et NorthwindEmployeeDeleted le délégué est appelé pour gérer Deleted l’événement une Delete fois l’opération terminée, à effectuer une gestion des exceptions.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. Dans cet exemple, si une NorthwindDataException exception est levée, elle est gérée par ce délégué.In this example, if a NorthwindDataException is thrown, it is handled by this delegate.

Pour examiner l’implémentation de l' EmployeeLogic objet métier de couche intermédiaire que cet exemple de code utilise, ObjectDataSourceStatusEventArgsconsultez.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>

Remarques

La méthode identifiée par la DeleteMethod propriété peut être une méthode d’instance ou une static méthode (Shared dans Visual Basic).The method that is identified by the DeleteMethod property can be an instance method or a static (Shared in Visual Basic) method. S’il s’agit d’une méthode d’instance, l’objet métier est créé et détruit chaque fois que la DeleteMethod méthode spécifiée par la propriété est appelée.If it is an instance method, the business object is created and destroyed each time the method specified by the DeleteMethod property is called. Vous pouvez gérer l' ObjectCreated événement pour qu’il fonctionne avec l’objet métier avant que la méthode DeleteMethod spécifiée par la propriété ne soit appelée.You can handle the ObjectCreated event to work with the business object before the method specified by the DeleteMethod property is called. Vous pouvez également gérer l' ObjectDisposing événement déclenché après l’appel de la méthode spécifiée par DeleteMethod la propriété.You can also handle the ObjectDisposing event that is raised after the method specified by the DeleteMethod property is called. Si la méthode est une static méthodeShared (dans Visual Basic), l’objet métier n’est jamais créé et vous ne pouvez pas gérer ces événements.If the method is a static (Shared in Visual Basic) method, the business object is never created and you cannot handle these events.

Si l’objet métier avec lequel ObjectDataSource le contrôle s’exécute implémente plusieurs méthodes ou fonctions portant le même nom (surcharges de méthode), le contrôle de source de données tente d’appeler l’objet approprié en fonction d’un ensemble de conditions, y compris les paramètres dans la DeleteParameters collection.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. Si les paramètres de la DeleteParameters collection ne correspondent pas à ceux de DeleteMethod la signature de la méthode, la source de données lève une exception.If the parameters in the DeleteParameters collection do not match those of the DeleteMethod method signature, the data source throws an exception.

La valeur de la DeleteMethod propriété est stockée dans l’état d’affichage.The value of the DeleteMethod property is stored in view state.

Pour plus d'informations, consultez DeleteMethod.For more information, see DeleteMethod.

S’applique à

Voir aussi