Freigeben über


ObjectDataSourceEventArgs Klasse

Definition

Stellt Daten für das ObjectCreating-Ereignis und das ObjectCreated-Ereignis des ObjectDataSource-Steuerelements bereit.

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. Im ersten Codebeispiel wird veranschaulicht, wie ein ObjectDataSource Steuerelement mit einem Geschäftsobjekt und einem GridView Steuerelement zum Abrufen und Anzeigen von Informationen verwendet wird. Im zweiten Codebeispiel wird das grundlegende Geschäftsobjekt bereitgestellt, das im ersten Codebeispiel verwendet wird.

Im folgenden Codebeispiel wird veranschaulicht, wie ein ObjectDataSource Steuerelement mit einem Geschäftsobjekt und einem GridView Steuerelement zum Abrufen und Anzeigen von Informationen verwendet wird. In diesem Beispiel ist es wie in vielen realen Szenarien möglicherweise nicht möglich oder angemessen, eine Standard-instance des Geschäftsobjekts mit dem ObjectDataSource -Steuerelement zu verwenden. In diesem Beispiel kann der ObjectDataSource parameterlose Konstruktor nicht erfolgreich aufgerufen werden, da eine Ausnahme ausgelöst wird. In einigen Fällen ist der parameterlose Konstruktor möglicherweise geschützt, in anderen wird das Geschäftsobjekt möglicherweise nicht in einem gewünschten Zustand initialisiert. Unabhängig vom Grund können Sie eine instance des Geschäftsobjekts selbst erstellen und die instance auf die ObjectInstance Eigenschaft des Objekts festlegen, das ObjectDataSourceEventArgs an den Handler übergeben wird. Dies ist das Geschäftsobjekt instance, das zum ObjectDataSource Ausführen seiner Arbeit verwendet wird.

<%@ 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 vorherigen Codebeispiel verwendet wird.

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 Methoden und OnObjectCreated verwendet, um Zugriff auf das Geschäftsobjekt instance zu ermöglichen, bevor Datenvorgänge ausgeführt werden, die das Steuerelement und das ObjectDataSource Geschäftsobjekt verwenden. Das Geschäftsobjekt wird festgelegt und mithilfe der ObjectInstance -Eigenschaft aufgerufen. Durch Hinzufügen eines Ereignishandlerdelegats zum Behandeln des ObjectCreating Ereignisses können Sie eine instance des Geschäftsobjekts im benutzerdefinierten Code erstellen, anstatt ObjectDataSource die Instanziierung durchzuführen. Dies ist nützlich, wenn Sie eine nicht standardmäßige instance Ihres Geschäftsobjekts oder einen nicht parameterlosen Konstruktor aufrufen möchten, um den instance zu erstellen. Der ObjectDataSource ruft immer den parameterlosen Konstruktor auf, um eine instance des Geschäftsobjekts zu erstellen, mit dem er arbeitet. Sie können auch einen Ereignishandlerdelegat hinzufügen, um das ObjectCreated Ereignis zu behandeln. Dadurch können Sie auf alle öffentlich verfügbar gemachten Member des Geschäftsobjekts zugreifen, um zusätzliche Initialisierungen oder Arbeiten auszuführen.

Die OnObjectCreating Methoden und OnObjectCreated werden vom ObjectDataSource -Steuerelement nicht aufgerufen, wenn die Geschäftsobjektmethode, die die Datenvorgänge ausführt, ist static.

Das ObjectDataSource Steuerelement macht viele Ereignisse verfügbar, die Sie behandeln können, um mit dem zugrunde liegenden Geschäftsobjekt zu verschiedenen Zeiten im Lebenszyklus zu arbeiten. In der folgenden Tabelle sind die Ereignisse und die zugehörigen EventArgs Klassen und Ereignishandlerdelegaten aufgeführt.

Ereignis EventArgs EventHandler
ObjectCreating.

Tritt unmittelbar vor dem erstellen instance des Geschäftsobjekts auf.
ObjectDataSourceEventArgs ObjectDataSourceObjectEventHandler
ObjectCreated.

Tritt unmittelbar nach dem Erstellen der instance des Geschäftsobjekts auf.
ObjectDataSourceEventArgs ObjectDataSourceObjectEventHandler
Selecting.

Tritt auf, bevor die Daten abgerufen werden.
ObjectDataSourceSelectingEventArgs ObjectDataSourceSelectingEventHandler
Inserting, Updatingund Deleting.

Tritt auf, bevor ein Einfüge-, Aktualisierungs- oder Löschvorgang ausgeführt wird.
ObjectDataSourceMethodEventArgs ObjectDataSourceMethodEventHandler
Selected.

Tritt auf, nachdem die Daten abgerufen wurden.
ObjectDataSourceStatusEventArgs ObjectDataSourceStatusEventHandler
Inserted, Updated, Deleted.

Tritt auf, nachdem der Einfüge-, Update- oder Löschvorgang abgeschlossen wurde.
ObjectDataSourceStatusEventArgs ObjectDataSourceStatusEventHandler
ObjectDisposing.

Tritt auf, bevor ein Geschäftsobjekt zerstört wird.
ObjectDataSourceDisposingEventArgs ObjectDataSourceDisposingEventHandler

Konstruktoren

ObjectDataSourceEventArgs(Object)

Initialisiert eine neue Instanz der ObjectDataSourceEventArgs-Klasse unter Verwendung des angegebenen Objekts.

Eigenschaften

ObjectInstance

Ruft ein Objekt ab, das das Geschäftsobjekt darstellt, mit dem das ObjectDataSource-Steuerelement Datenoperationen ausführt, oder legt dieses fest.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen