Auf Englisch lesen

Freigeben über

ObjectDataSourceMethodEventHandler Delegat

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Stellt die Methode zur Behandlung der folgenden Ereignisse des Selecting-Steuerelements dar: Updating, Inserting, Deleting oder ObjectDataSource.

C# 
public delegate void ObjectDataSourceMethodEventHandler(object sender, ObjectDataSourceMethodEventArgs e);

Parameter

sender
Object

Die Quelle des Ereignisses: ObjectDataSource.

e
ObjectDataSourceMethodEventArgs

Ein ObjectDataSourceMethodEventArgs, das die Ereignisdaten enthält.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie Ein ObjectDataSource -Steuerelement mit einem Geschäftsobjekt und einem DetailsView -Steuerelement zum Einfügen von Daten verwendet wird. Das zweite Codebeispiel stellt ein Beispiel für ein Geschäftsobjekt der mittleren Ebene bereit, das vom ersten Codebeispiel verwendet wird.

Im folgenden Codebeispiel wird veranschaulicht, wie Ein ObjectDataSource -Steuerelement mit einem Geschäftsobjekt und einem DetailsView -Steuerelement zum Einfügen von Daten verwendet wird. Zunächst DetailsView wird ein neuer NorthwindEmployee Datensatz zusammen mit einer automatisch generierten Schaltfläche Einfügen angezeigt. Nachdem Sie Daten in die Felder des DetailsView Steuerelements eingegeben haben, klicken Sie auf die Schaltfläche Einfügen , und die InsertMethod -Eigenschaft identifiziert, welche Methode die Insert Aktion ausführt.

In diesem Beispiel wird die UpdateEmployeeInfo -Methode verwendet, um eine Einfügung auszuführen. Sie erfordert jedoch einen NorthwindEmployee Parameter, um die Daten einzufügen. Aus diesem Grund ist die Sammlung von Zeichenfolgen, die das DetailsView Steuerelement automatisch übergibt, nicht ausreichend. Der NorthwindEmployeeInserting Delegat ist ein ObjectDataSourceMethodEventHandler Objekt, das das Inserting Ereignis behandelt und es Ihnen ermöglicht, die Eingabeparameter zu bearbeiten, bevor der Insert Vorgang fortgesetzt wird. Da die UpdateEmployeeInfo -Methode ein NorthwindEmployee -Objekt als Parameter erfordert, wird eines mithilfe der Auflistung von Zeichenfolgen erstellt und der InputParameters Auflistung hinzugefügt.

ASP.NET (C#) 
<%@ 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 NorthwindEmployeeInserting(object source, ObjectDataSourceMethodEventArgs e)
{
  // The business object expects a custom type. Build it
  // and add it to the parameters collection.
  
  IDictionary paramsFromPage = e.InputParameters;

  NorthwindEmployee ne = new NorthwindEmployee();

  ne.FirstName  = paramsFromPage["FirstName"].ToString();
  ne.LastName   = paramsFromPage["LastName"].ToString();
  ne.Title      = paramsFromPage["Title"].ToString();
  ne.Courtesy   = paramsFromPage["Courtesy"].ToString();
  ne.Supervisor = Int32.Parse(paramsFromPage["Supervisor"].ToString());

  paramsFromPage.Clear();
  paramsFromPage.Add("ne", ne);
}

</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:detailsview
          id="DetailsView1"
          runat="server"
          autogenerateinsertbutton="True"
          datasourceid="ObjectDataSource1">
        </asp:detailsview>

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          insertmethod="UpdateEmployeeInfo"
          oninserting="NorthwindEmployeeInserting"
          typename="Samples.AspNet.CS.EmployeeLogic"
          >
          <selectparameters>
            <asp:parameter name="anID" defaultvalue="-1" />
          </selectparameters>
        </asp:objectdatasource>

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

Im folgenden Codebeispiel wird das Im vorherigen Codebeispiel verwendete Geschäftsobjekt der mittleren Ebene bereitgestellt. Das Codebeispiel besteht aus den folgenden zwei grundlegenden Klassen und einer zusätzlichen Klasse:

  • Die EmployeeLogic -Klasse, bei der es sich um eine zustandslose Klasse handelt, die Geschäftslogik kapselt.

  • Die NorthwindEmployee -Klasse, bei der es sich um eine Modellklasse handelt, die nur die grundlegenden Funktionen enthält, die zum Laden und Beibehalten von Daten aus der Datenebene erforderlich sind.

  • Eine zusätzliche NorthwindDataException Klasse, die zur Vereinfachung bereitgestellt wird.

Dieser Satz von Beispielklassen funktioniert mit der Northwind Traders-Datenbank, einer Beispieldatenbank, die mit Microsoft SQL Server und Microsoft Access verfügbar ist. Verwenden Sie für ein vollständiges Funktionierendes Beispiel diese Klassen, indem Sie sie im Verzeichnis App_Code unter dem Anwendungsstamm ablegen oder sie in eine Bibliothek kompilieren und die resultierende DLL im Verzeichnis Bin ablegen. Die UpdateEmployeeInfo -Methode ist nicht vollständig implementiert, sodass Sie keine Daten in die Northwind Traders-Datenbank einfügen, wenn Sie mit diesem Beispiel experimentieren.

C# 
namespace Samples.AspNet.CS {

using System;
using System.Collections;
using System.Configuration;
using System.Data;
using System.Data.SqlClient;
using System.Web.UI;
using System.Web.UI.WebControls;
  //
  // EmployeeLogic is a stateless business object that encapsulates
  // the operations you can perform on a NorthwindEmployee object.
  //
  public class EmployeeLogic {

    // Returns a collection of NorthwindEmployee objects.
    public static ICollection GetAllEmployees () {
      ArrayList al = new ArrayList();

      ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];

      SqlDataSource sds
        = new SqlDataSource(cts.ConnectionString,
                            "SELECT EmployeeID FROM Employees");
      try {
        IEnumerable IDs = sds.Select(DataSourceSelectArguments.Empty);

        // Iterate through the Enumeration and create a
        // NorthwindEmployee object for each ID.
        IEnumerator enumerator = IDs.GetEnumerator();
        while (enumerator.MoveNext()) {
          // The IEnumerable contains DataRowView objects.
          DataRowView row = enumerator.Current as DataRowView;
          string id = row["EmployeeID"].ToString();
          NorthwindEmployee nwe = new NorthwindEmployee(id);
          // Add the NorthwindEmployee object to the collection.
          al.Add(nwe);
        }
      }
      finally {
        // If anything strange happens, clean up.
        sds.Dispose();
      }

      return al;
    }

    public static NorthwindEmployee GetEmployee(object anID) {
      if (anID.Equals("-1") ||
          anID.Equals(DBNull.Value) ) {
        return new NorthwindEmployee();
      }
      else {
        return new NorthwindEmployee(anID);
      }
    }

    public static void UpdateEmployeeInfo(NorthwindEmployee ne) {
      bool retval = ne.Save();
      if (!retval) { throw new NorthwindDataException("UpdateEmployee failed."); }
    }

    public static void DeleteEmployee(NorthwindEmployee ne) {
      bool retval = ne.Delete();
      if (!retval) { throw new NorthwindDataException("DeleteEmployee failed."); }
    }

    // And so on...
  }

  public class NorthwindEmployee {

    public NorthwindEmployee () {
      ID = DBNull.Value;
      lastName = "";
      firstName = "";
      title="";
      titleOfCourtesy = "";
      reportsTo = -1;
    }

    public NorthwindEmployee (object anID) {
      this.ID = anID;

      SqlConnection conn
        = new SqlConnection (ConfigurationManager.ConnectionStrings["NorthwindConnection"].ConnectionString);
      SqlCommand sc =
        new SqlCommand(" SELECT FirstName,LastName,Title,TitleOfCourtesy,ReportsTo " +
                       " FROM Employees " +
                       " WHERE EmployeeID = @empId",
                       conn);
      // Add the employee ID parameter and set its value.
      sc.Parameters.Add(new SqlParameter("@empId",SqlDbType.Int)).Value = Int32.Parse(anID.ToString());
      SqlDataReader sdr = null;

      try {
        conn.Open();
        sdr = sc.ExecuteReader();

        // Only loop once.
        if (sdr != null && sdr.Read()) {
          // The IEnumerable contains DataRowView objects.
          this.firstName        = sdr["FirstName"].ToString();
          this.lastName         = sdr["LastName"].ToString();
          this.title            = sdr["Title"].ToString();
          this.titleOfCourtesy  = sdr["TitleOfCourtesy"].ToString();
          if (!sdr.IsDBNull(4)) {
            this.reportsTo        = sdr.GetInt32(4);
          }
        }
        else {
          throw new NorthwindDataException("Data not loaded for employee id.");
        }
      }
      finally {
        try {
          if (sdr != null) sdr.Close();
          conn.Close();
        }
        catch (SqlException) {
          // Log an event in the Application Event Log.
          throw;
        }
      }
    }

    private object ID;
    public string EmpID {
      get { return ID.ToString();  }
    }

    private string lastName;
    public string LastName {
      get { return lastName; }
      set { lastName = value; }
    }

    private string firstName;
    public string FirstName {
      get { return firstName; }
      set { firstName = value;  }
    }

    public string FullName {
      get { return FirstName + " " + LastName; }
    }

    private string title;
    public String Title {
      get { return title; }
      set { title = value; }
    }

    private string titleOfCourtesy;
    public string Courtesy {
      get { return titleOfCourtesy; }
      set { titleOfCourtesy = value; }
    }

    private int    reportsTo;
    public int Supervisor {
      get { return reportsTo; }
      set { reportsTo = value; }
    }

    public bool Save () {
      // Implement persistence logic.
      return true;
    }

    public bool Delete () {
      // Implement delete logic.
      return true;
    }
  }

  internal class NorthwindDataException: Exception {
    public NorthwindDataException(string msg) : base (msg) { }
  }
}

Hinweise

Mit dem Selecting- , InsertingUpdating- oder Deleting -Ereignis des ObjectDataSource Steuerelements können Sie die Parameter bearbeiten, die verwendet werden, um die methode zu bestimmen, die ObjectDataSource vom Steuerelement aufgerufen wird. Weitere Informationen finden Sie unter ObjectDataSourceMethodEventArgs.

Beim Erstellen eines ObjectDataSourceMethodEventHandler-Delegaten geben Sie die Methode für die Ereignisbehandlung an. Um dem Ereignishandler das Ereignis zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu. Der Ereignishandler wird bei jedem Eintreten des Ereignisses aufgerufen, sofern der Delegat nicht entfernt wird. Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Erweiterungsmethoden

GetMethodInfo(Delegate)

Ruft ein Objekt ab, das die Methode darstellt, die vom angegebenen Delegaten dargestellt wird.

Gilt für:

Produkt Versionen
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Weitere Informationen