ObjectDataSourceEventArgs Klasse

Definition

Stellt Daten für das ObjectCreating-Ereignis und das ObjectCreated-Ereignis des ObjectDataSource-Steuerelements bereit.Provides data for the ObjectCreating and ObjectCreated events of the ObjectDataSource control.

public ref class ObjectDataSourceEventArgs : EventArgs
public class ObjectDataSourceEventArgs : EventArgs
type ObjectDataSourceEventArgs = class
    inherit EventArgs
Public Class ObjectDataSourceEventArgs
Inherits EventArgs
Vererbung
ObjectDataSourceEventArgs

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele.This section contains two code examples. Im ersten Codebeispiel wird veranschaulicht, wie ein ObjectDataSource -Steuerelement mit einem Geschäftsobjekt GridView und einem-Steuerelement verwendet wird, um Informationen abzurufen und anzuzeigen.The first code example demonstrates how to use an ObjectDataSource control with a business object and a GridView control to retrieve and display information. Im zweiten Codebeispiel wird das grundlegende Geschäftsobjekt bereitstellt, das im ersten Codebeispiel verwendet wird.The second code example provides the example basic business object that the first code example uses.

Im folgenden Codebeispiel wird veranschaulicht, wie ein ObjectDataSource -Steuerelement mit einem Geschäftsobjekt GridView und einem-Steuerelement verwendet wird, um Informationen abzurufen und anzuzeigen.The following code example demonstrates how to use an ObjectDataSource control with a business object and a GridView control to retrieve and display information. In diesem Beispiel, wie in vielen realen Szenarien, ist es möglicherweise nicht möglich, eine Standard Instanz des Geschäftsobjekts mit dem ObjectDataSource Steuerelement zu verwenden.In this example, as in many real-world scenarios, it might not be possible nor appropriate to use a default instance of the business object with the ObjectDataSource control. In diesem Beispiel kann der ObjectDataSource Parameter lose Konstruktor nicht erfolgreich aufgerufen werden, da er eine Ausnahme auslöst.In this example, the ObjectDataSource cannot successfully call the parameterless constructor because it will throw an exception. In einigen Fällen kann der Parameter lose Konstruktor geschützt sein, und in anderen Fällen wird das Geschäftsobjekt möglicherweise nicht in einem gewünschten Zustand initialisiert.In some cases, the parameterless constructor might be protected and in others it might not initialize the business object to a desired state. Der Grund hierfür ist, dass Sie selbst eine Instanz des Geschäftsobjekts erstellen und die-Instanz auf die ObjectInstance -Eigenschaft ObjectDataSourceEventArgs des-Objekts festlegen können, das an den-Handler übermittelt wird.Whatever the reason, you can create an instance of the business object yourself and set the instance to the ObjectInstance property of the ObjectDataSourceEventArgs object that is passed to the handler. Dies ist die Geschäftsobjekt Instanz, die ObjectDataSource von verwendet wird, um Ihre Arbeit auszuführen.This is the business object instance that the ObjectDataSource will use to perform its work.

<%@ 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 NorthwindLogicCreating(object sender, ObjectDataSourceEventArgs e)
{
    // Create an instance of the business object using a non-default constructor.
    EmployeeLogic eLogic = new EmployeeLogic("Not created by the default constructor!");
    
    // Set the ObjectInstance property so that the ObjectDataSource uses the created instance.
    e.ObjectInstance = eLogic;
}

</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">
        </asp:gridview>

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          onobjectcreating="NorthwindLogicCreating"
          typename="Samples.AspNet.CS.EmployeeLogic" >
        </asp:objectdatasource>

    </form>
  </body>
</html>
<%@ 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">
Private Sub NorthwindLogicCreating(sender As Object, e As ObjectDataSourceEventArgs)

    ' Create an instance of the business object using a non-default constructor.
    Dim eLogic As EmployeeLogic = New EmployeeLogic("Not created by the default constructor!")
    
    ' Set the ObjectInstance property so that the ObjectDataSource uses the created instance.
    e.ObjectInstance = eLogic
    
End Sub ' NorthwindLogicCreating

</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">
        </asp:gridview>

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          onobjectcreating="NorthwindLogicCreating"
          typename="Samples.AspNet.VB.EmployeeLogic" >
        </asp:objectdatasource>

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

Im folgenden Codebeispiel wird das grundlegende Geschäftsobjekt veranschaulicht, das im vorangehenden Codebeispiel verwendet wird.The following code example demonstrates the example basic business object that the preceding code example uses.

namespace Samples.AspNet.CS {

using System;
using System.Collections;
using System.Web.UI;
using System.Web.UI.WebControls;

  public class EmployeeLogic {

    public EmployeeLogic() {  
        throw new NotSupportedException("Initialize data.");
    }
    
    public EmployeeLogic(string data) {
        _data = data;
    }

    private string _data;
    
    // Returns a collection of NorthwindEmployee objects.
    public ICollection GetAllEmployees () {
      ArrayList al = new ArrayList();      
      al.Add(_data);        
      return al;
    }
    
  }

}
Imports System.Collections
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB
  Public Class EmployeeLogic
    
    
    Public Sub New() 
        Throw New NotSupportedException("Initialize data.")
    
    End Sub
    
    
    Public Sub New(ByVal data As String) 
        _data = data
    
    End Sub
    
    Private _data As String
    
    
    ' Returns a collection of NorthwindEmployee objects.
    Public Function GetAllEmployees() As ICollection 
        Dim al As New ArrayList()
        al.Add(_data)
        Return al
    
    End Function 'GetAllEmployees
  End Class
End Namespace ' Samples.AspNet.VB

Hinweise

Die ObjectDataSourceEventArgs -Klasse wird in den OnObjectCreating - OnObjectCreated und-Methoden verwendet, um Zugriff auf die Geschäftsobjekt Instanz bereitzustellen, bevor Daten ObjectDataSource Vorgänge ausgeführt werden, die das-Steuerelement und das Geschäftsobjekt verwenden.The ObjectDataSourceEventArgs class is used in the OnObjectCreating and OnObjectCreated methods to provide access to the business object instance before any data operations that are using the ObjectDataSource control and business object are performed. Das Geschäftsobjekt wird festgelegt, und der ObjectInstance Zugriff erfolgt über die-Eigenschaft.The business object is set and accessed using the ObjectInstance property. Wenn Sie einen Ereignishandlerdelegaten ObjectCreating hinzufügen, um das-Ereignis zu behandeln, können Sie eine Instanz des Geschäftsobjekts ObjectDataSource in benutzerdefiniertem Code erstellen, anstatt die Instanziierung auszuführen.By adding an event handler delegate to handle the ObjectCreating event, you can create an instance of the business object in custom code instead of the ObjectDataSource performing the instantiation. Dies ist hilfreich, wenn Sie eine nicht standardmäßige Instanz Ihres Geschäftsobjekts oder einen nicht parameterlosen Konstruktor zum Erstellen der Instanz abrufen möchten. Ruft ObjectDataSource immer den Parameter losen Konstruktor auf, um eine Instanz des Geschäftsobjekts zu erstellen, mit der es arbeitet.This is useful when you want a non-default instance of your business object or to call a non-parameterless constructor to create the instance; the ObjectDataSource always calls the parameterless constructor to create an instance of the business object it works with. Sie können auch einen Ereignishandlerdelegaten hinzu ObjectCreated fügen, um das-Ereignis zu behandeln. Dadurch können Sie auf öffentlich verfügbar gemachte Member des Geschäftsobjekts zugreifen, um zusätzliche Initialisierung oder Arbeit auszuführen.You can also add an event handler delegate to handle the ObjectCreated event, which enables you to access any publicly exposed members of the business object to perform any additional initialization or work.

Die OnObjectCreating - OnObjectCreated Methode und die-Methode ObjectDataSource werden vom-Steuerelement nicht aufgerufen, wenn die Geschäftsobjekt Methode, staticdie die Daten Vorgänge ausführt, ist.The OnObjectCreating and OnObjectCreated methods are not called by the ObjectDataSource control, if the business object method that performs the data operations is static.

Das ObjectDataSource -Steuerelement macht viele Ereignisse verfügbar, die Sie verarbeiten können, um zu verschiedenen Zeitpunkten im Lebenszyklus mit dem zugrunde liegenden Geschäftsobjekt zu arbeiten.The ObjectDataSource control exposes many events that you can handle to work with the underlying business object at various times in its lifecycle. In der folgenden Tabelle werden die-Ereignisse sowie EventArgs die zugehörigen Klassen und Ereignishandlerdelegaten aufgelistet.The following table lists the events and the associated EventArgs classes and event handler delegates.

eventEvent EventArgsEventArgs EventHandlerEventHandler
ObjectCreating.ObjectCreating.

Tritt unmittelbar vor dem Erstellen der Instanz des Geschäftsobjekts auf.Occurs immediately before the instance of the business object is created.
ObjectDataSourceEventArgs ObjectDataSourceObjectEventHandler
ObjectCreated.ObjectCreated.

Tritt unmittelbar nach dem Erstellen der Instanz des Geschäftsobjekts auf.Occurs immediately after the instance of the business object is created.
ObjectDataSourceEventArgs ObjectDataSourceObjectEventHandler
Selecting.Selecting.

Tritt ein, bevor die Daten abgerufen werden.Occurs before the data is retrieved.
ObjectDataSourceSelectingEventArgs ObjectDataSourceSelectingEventHandler
Inserting, Updating und Deleting.Inserting, Updating, and Deleting.

Tritt auf, bevor ein INSERT-, Update-oder DELETE-Vorgang ausgeführt wird.Occur before an insert, update, or delete operation is performed.
ObjectDataSourceMethodEventArgs ObjectDataSourceMethodEventHandler
Selected.Selected.

Tritt ein, nachdem die Daten abgerufen wurden.Occurs after the data is retrieved.
ObjectDataSourceStatusEventArgs ObjectDataSourceStatusEventHandler
Inserted, Updated, Deleted.Inserted, Updated, Deleted.

Tritt auf, nachdem der INSERT-, Update-oder DELETE-Vorgang abgeschlossen wurde.Occur after the insert, update, or delete operation is completed.
ObjectDataSourceStatusEventArgs ObjectDataSourceStatusEventHandler
ObjectDisposing.ObjectDisposing.

Tritt ein, bevor ein Geschäftsobjekt zerstört wird.Occurs before a business object is destroyed.
ObjectDataSourceDisposingEventArgs ObjectDataSourceDisposingEventHandler

Konstruktoren

ObjectDataSourceEventArgs(Object)

Initialisiert eine neue Instanz der ObjectDataSourceEventArgs-Klasse unter Verwendung des angegebenen Objekts.Initializes a new instance of the ObjectDataSourceEventArgs class using the specified object.

Eigenschaften

ObjectInstance

Ruft ein Objekt ab, das das Geschäftsobjekt darstellt, mit dem das ObjectDataSource-Steuerelement Datenoperationen ausführt, oder legt dieses fest.Gets or sets an object that represents the business object with which the ObjectDataSource control performs data operations.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch