ObjectDataSourceEventArgs Classe

Définition

Fournit des données pour les événements ObjectCreating et ObjectCreated du contrôle ObjectDataSource.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
Héritage
ObjectDataSourceEventArgs

Exemples

Cette section contient deux exemples de code.This section contains two code examples. Le premier exemple de code montre comment utiliser un ObjectDataSource contrôle avec un objet métier et un GridView contrôle pour récupérer et afficher des informations.The first code example demonstrates how to use an ObjectDataSource control with a business object and a GridView control to retrieve and display information. Le second exemple de code fournit l’exemple d’objet métier de base utilisé par le premier exemple de code.The second code example provides the example basic business object that the first code example uses.

L’exemple de code suivant montre comment utiliser un ObjectDataSource contrôle avec un objet métier et un GridView contrôle pour récupérer et afficher des informations.The following code example demonstrates how to use an ObjectDataSource control with a business object and a GridView control to retrieve and display information. Dans cet exemple, comme dans de nombreux scénarios réels, il n’est pas possible ou approprié d’utiliser une instance par défaut de l’objet métier avec le ObjectDataSource contrôle.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. Dans cet exemple, le ObjectDataSource ne peut pas appeler correctement le constructeur sans paramètre, car il lèvera une exception.In this example, the ObjectDataSource cannot successfully call the parameterless constructor because it will throw an exception. Dans certains cas, le constructeur sans paramètre peut être protégé et, dans d’autres, il peut ne pas initialiser l’objet métier à un état souhaité.In some cases, the parameterless constructor might be protected and in others it might not initialize the business object to a desired state. Quelle que soit la raison, vous pouvez créer vous-même une instance de l’objet métier et définir ObjectInstance l’instance sur ObjectDataSourceEventArgs la propriété de l’objet qui est passé au gestionnaire.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. Il s’agit de l’instance d’objet ObjectDataSource métier que le utilisera pour effectuer son travail.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>

L’exemple de code suivant illustre l’exemple d’objet métier de base que l’exemple de code précédent utilise.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

Remarques

La ObjectDataSourceEventArgs classe est utilisée dans les OnObjectCreating méthodes OnObjectCreated et pour fournir l’accès à l’instance de l’objet métier avant toute opération de données ObjectDataSource qui utilise le contrôle et l’objet métier.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. L’objet métier est défini et accessible à l' ObjectInstance aide de la propriété.The business object is set and accessed using the ObjectInstance property. En ajoutant un délégué de gestionnaire d’événements pour ObjectCreating gérer l’événement, vous pouvez créer une instance de l’objet métier dans du code personnalisé ObjectDataSource au lieu d’effectuer l’instanciation.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. Cela est utile lorsque vous souhaitez une instance non définie par défaut de votre objet métier ou appeler un constructeur sans paramètre pour créer l’instance; le ObjectDataSource appelle toujours le constructeur sans paramètre pour créer une instance de l’objet métier avec lequel il fonctionne.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. Vous pouvez également ajouter un délégué de gestionnaire d’événements pour ObjectCreated gérer l’événement, ce qui vous permet d’accéder à tous les membres exposés publiquement de l’objet métier pour effectuer une initialisation ou un travail supplémentaire.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.

Les OnObjectCreating méthodes OnObjectCreated et ne sont pas appelées ObjectDataSource par le contrôle, si la méthode de l’objet métier qui effectue staticles opérations de données est.The OnObjectCreating and OnObjectCreated methods are not called by the ObjectDataSource control, if the business object method that performs the data operations is static.

Le ObjectDataSource contrôle expose de nombreux événements que vous pouvez gérer pour travailler avec l’objet métier sous-jacent à différents moments dans son cycle de vie.The ObjectDataSource control exposes many events that you can handle to work with the underlying business object at various times in its lifecycle. Le tableau suivant répertorie les événements et les EventArgs classes associées et les délégués de gestionnaires d’événements.The following table lists the events and the associated EventArgs classes and event handler delegates.

événementEvent EventArgsEventArgs DéléguéEventHandler
ObjectCreating.ObjectCreating.

Se produit immédiatement avant la création de l’instance de l’objet métier.Occurs immediately before the instance of the business object is created.
ObjectDataSourceEventArgs ObjectDataSourceObjectEventHandler
ObjectCreated.ObjectCreated.

Se produit immédiatement après la création de l’instance de l’objet métier.Occurs immediately after the instance of the business object is created.
ObjectDataSourceEventArgs ObjectDataSourceObjectEventHandler
Selecting.Selecting.

Se produit avant que les données ne soient récupérées.Occurs before the data is retrieved.
ObjectDataSourceSelectingEventArgs ObjectDataSourceSelectingEventHandler
Inserting, Updating et Deleting.Inserting, Updating, and Deleting.

Se produit avant l’exécution d’une opération d’insertion, de mise à jour ou de suppression.Occur before an insert, update, or delete operation is performed.
ObjectDataSourceMethodEventArgs ObjectDataSourceMethodEventHandler
Selected.Selected.

Se produit une fois que les données ont été récupérées.Occurs after the data is retrieved.
ObjectDataSourceStatusEventArgs ObjectDataSourceStatusEventHandler
Inserted, Updated, Deleted.Inserted, Updated, Deleted.

Se produisent une fois l’opération d’insertion, de mise à jour ou de suppression terminée.Occur after the insert, update, or delete operation is completed.
ObjectDataSourceStatusEventArgs ObjectDataSourceStatusEventHandler
ObjectDisposing.ObjectDisposing.

Se produit avant la destruction d’un objet métier.Occurs before a business object is destroyed.
ObjectDataSourceDisposingEventArgs ObjectDataSourceDisposingEventHandler

Constructeurs

ObjectDataSourceEventArgs(Object)

Initialise une nouvelle instance de la classe ObjectDataSourceEventArgs à l'aide de l'objet spécifié.Initializes a new instance of the ObjectDataSourceEventArgs class using the specified object.

Propriétés

ObjectInstance

Obtient ou définit un objet qui représente l'objet métier avec lequel le contrôle ObjectDataSource exécute des opérations de données.Gets or sets an object that represents the business object with which the ObjectDataSource control performs data operations.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi