ObjectDataSourceEventArgs Classe

Definizione

Fornisce i dati per gli eventi ObjectCreating e ObjectCreated del controllo 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
Ereditarietà
ObjectDataSourceEventArgs

Esempi

In questa sezione sono riportati due esempi di codice.This section contains two code examples. Nel primo esempio di codice viene illustrato come utilizzare ObjectDataSource un controllo con un oggetto business e GridView un controllo per recuperare e visualizzare informazioni.The first code example demonstrates how to use an ObjectDataSource control with a business object and a GridView control to retrieve and display information. Il secondo esempio di codice fornisce l'oggetto business di base di esempio usato dal primo esempio di codice.The second code example provides the example basic business object that the first code example uses.

Nell'esempio di codice riportato di seguito viene illustrato ObjectDataSource come utilizzare un controllo con un oggetto GridView business e un controllo per recuperare e visualizzare informazioni.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 questo esempio, come in molti scenari reali, potrebbe non essere possibile, né appropriato, utilizzare un'istanza predefinita dell'oggetto business con il ObjectDataSource controllo.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 questo esempio, ObjectDataSource non è in grado di chiamare correttamente il costruttore senza parametri perché genererà un'eccezione.In this example, the ObjectDataSource cannot successfully call the parameterless constructor because it will throw an exception. In alcuni casi, il costruttore senza parametri potrebbe essere protetto e in altri potrebbe non inizializzare l'oggetto business allo stato desiderato.In some cases, the parameterless constructor might be protected and in others it might not initialize the business object to a desired state. Qualunque sia il motivo, è possibile creare un'istanza dell'oggetto business autonomamente e impostare l'istanza ObjectInstance sulla proprietà ObjectDataSourceEventArgs dell'oggetto passato al gestore.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. Si tratta dell'istanza dell'oggetto business che ObjectDataSource verrà utilizzata da per eseguire le operazioni.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>

Nell'esempio di codice riportato di seguito viene illustrato l'esempio di oggetto business di base utilizzato nell'esempio di codice precedente.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

Commenti

La ObjectDataSourceEventArgs classe viene utilizzata OnObjectCreating nei metodi e OnObjectCreated per consentire l'accesso all'istanza dell'oggetto business prima di eseguire qualsiasi operazione sui dati che ObjectDataSource utilizza il controllo e l'oggetto business.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'oggetto business viene impostato e a cui si ObjectInstance accede utilizzando la proprietà.The business object is set and accessed using the ObjectInstance property. Aggiungendo un delegato del gestore eventi per gestire l' ObjectCreating evento, è possibile creare un'istanza dell'oggetto business nel codice personalizzato anziché ObjectDataSource eseguire la creazione di istanze.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. Questa operazione è utile quando si desidera un'istanza non predefinita dell'oggetto business o per chiamare un costruttore senza parametri per creare l'istanza. chiama ObjectDataSource sempre il costruttore senza parametri per creare un'istanza dell'oggetto business con cui funziona.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. È anche possibile aggiungere un delegato del gestore eventi per gestire ObjectCreated l'evento, che consente di accedere a tutti i membri esposti pubblicamente dell'oggetto business per eseguire qualsiasi inizializzazione o lavoro aggiuntivo.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.

I OnObjectCreating metodi OnObjectCreated e static nonObjectDataSource vengono chiamati dal controllo, se il metodo dell'oggetto business che esegue le operazioni sui dati è.The OnObjectCreating and OnObjectCreated methods are not called by the ObjectDataSource control, if the business object method that performs the data operations is static.

Il ObjectDataSource controllo espone molti eventi che è possibile gestire per lavorare con l'oggetto business sottostante in diversi momenti del ciclo di vita.The ObjectDataSource control exposes many events that you can handle to work with the underlying business object at various times in its lifecycle. Nella tabella seguente sono elencati gli eventi e le EventArgs classi associate e i delegati del gestore eventi.The following table lists the events and the associated EventArgs classes and event handler delegates.

eventEvent EventArgsEventArgs EventHandlerEventHandler
ObjectCreating.ObjectCreating.

Si verifica immediatamente prima della creazione dell'istanza dell'oggetto business.Occurs immediately before the instance of the business object is created.
ObjectDataSourceEventArgs ObjectDataSourceObjectEventHandler
ObjectCreated.ObjectCreated.

Si verifica immediatamente dopo la creazione dell'istanza dell'oggetto business.Occurs immediately after the instance of the business object is created.
ObjectDataSourceEventArgs ObjectDataSourceObjectEventHandler
Selecting.Selecting.

Si verifica prima che vengano recuperati i dati.Occurs before the data is retrieved.
ObjectDataSourceSelectingEventArgs ObjectDataSourceSelectingEventHandler
Inserting, Updating e Deleting.Inserting, Updating, and Deleting.

Si verificano prima dell'esecuzione di un'operazione di inserimento, aggiornamento o eliminazione.Occur before an insert, update, or delete operation is performed.
ObjectDataSourceMethodEventArgs ObjectDataSourceMethodEventHandler
Selected.Selected.

Si verifica dopo che i dati sono stati recuperati.Occurs after the data is retrieved.
ObjectDataSourceStatusEventArgs ObjectDataSourceStatusEventHandler
Inserted, Updated, Deleted.Inserted, Updated, Deleted.

Si verifica dopo il completamento dell'operazione di inserimento, aggiornamento o eliminazione.Occur after the insert, update, or delete operation is completed.
ObjectDataSourceStatusEventArgs ObjectDataSourceStatusEventHandler
ObjectDisposing.ObjectDisposing.

Si verifica prima che un oggetto business venga eliminato definitivamente.Occurs before a business object is destroyed.
ObjectDataSourceDisposingEventArgs ObjectDataSourceDisposingEventHandler

Costruttori

ObjectDataSourceEventArgs(Object)

Inizializza una nuova istanza della classe ObjectDataSourceEventArgs utilizzando l'oggetto specificato.Initializes a new instance of the ObjectDataSourceEventArgs class using the specified object.

Proprietà

ObjectInstance

Ottiene o imposta un oggetto che rappresenta l'oggetto business con cui il controllo ObjectDataSource esegue le operazioni dati.Gets or sets an object that represents the business object with which the ObjectDataSource control performs data operations.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche