ObjectDataSource.ObjectCreating Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica prima della creazione dell'oggetto identificato dalla proprietà TypeName.
public:
event System::Web::UI::WebControls::ObjectDataSourceObjectEventHandler ^ ObjectCreating;public event System.Web.UI.WebControls.ObjectDataSourceObjectEventHandler ObjectCreating;member this.ObjectCreating : System.Web.UI.WebControls.ObjectDataSourceObjectEventHandler Public Custom Event ObjectCreating As ObjectDataSourceObjectEventHandler Tipo evento
Esempio
In questa sezione sono riportati due esempi di codice. Il primo esempio di codice illustra come usare un oggetto con un ObjectDataSource oggetto business e un GridView controllo per visualizzare le informazioni. Il secondo esempio di codice fornisce l'oggetto business di livello intermedio usato nel primo esempio di codice.
Nell'esempio di codice seguente viene illustrato come usare un controllo con un ObjectDataSource oggetto business e un GridView controllo per visualizzare informazioni. È possibile usare un oggetto business molto costoso per creare (in termini di tempo o risorse) per ogni operazione di dati eseguita dalla pagina Web. Un modo per usare un oggetto costoso potrebbe essere creare un'istanza di essa una volta e quindi memorizzarla nella cache per le operazioni successive anziché crearla e distruggerla per ogni operazione di dati.
Nota
In un'applicazione di produzione più richieste potrebbero terminare contemporaneamente usando la stessa istanza. Pertanto, l'oggetto deve essere implementato in modo thread-safe.
Questo esempio di codice illustra questo modello. È possibile gestire l'evento ObjectCreating per controllare prima la cache per un oggetto e creare solo un'istanza dell'oggetto, se non è già memorizzata nella cache. Gestire quindi l'evento per memorizzare nella cache l'oggetto ObjectDisposing business per l'uso futuro, anziché eliminarlo. In questo esempio di codice la CancelEventArgs.Cancel proprietà dell'oggetto ObjectDataSourceDisposingEventArgs è impostata su per indirizzare il metodo a true non chiamare Dispose il ObjectDataSource metodo sull'oggetto.
<%@ 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">
// Instead of creating and destroying the business object each time, the
// business object is cached in the ASP.NET Cache.
private void GetEmployeeLogic(object sender, ObjectDataSourceEventArgs e)
{
// First check to see if an instance of this object already exists in the Cache.
EmployeeLogic cachedLogic;
cachedLogic = Cache["ExpensiveEmployeeLogicObject"] as EmployeeLogic;
if (null == cachedLogic) {
cachedLogic = new EmployeeLogic();
}
e.ObjectInstance = cachedLogic;
}
private void ReturnEmployeeLogic(object sender, ObjectDataSourceDisposingEventArgs e)
{
// Get the instance of the business object that the ObjectDataSource is working with.
EmployeeLogic cachedLogic = e.ObjectInstance as EmployeeLogic;
// Test to determine whether the object already exists in the cache.
EmployeeLogic temp = Cache["ExpensiveEmployeeLogicObject"] as EmployeeLogic;
if (null == temp) {
// If it does not yet exist in the Cache, add it.
Cache.Insert("ExpensiveEmployeeLogicObject", cachedLogic);
}
// Cancel the event, so that the object will
// not be Disposed if it implements IDisposable.
e.Cancel = true;
}
</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="GetCreateTime"
typename="Samples.AspNet.CS.EmployeeLogic"
onobjectcreating="GetEmployeeLogic"
onobjectdisposing="ReturnEmployeeLogic" >
</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">
' Instead of creating and destroying the business object each time, the
' business object is cached in the ASP.NET Cache.
Sub GetEmployeeLogic(sender As Object, e As ObjectDataSourceEventArgs)
' First check to see if an instance of this object already exists in the Cache.
Dim cachedLogic As EmployeeLogic
cachedLogic = CType( Cache("ExpensiveEmployeeLogicObject"), EmployeeLogic)
If (cachedLogic Is Nothing) Then
cachedLogic = New EmployeeLogic
End If
e.ObjectInstance = cachedLogic
End Sub ' GetEmployeeLogic
Sub ReturnEmployeeLogic(sender As Object, e As ObjectDataSourceDisposingEventArgs)
' Get the instance of the business object that the ObjectDataSource is working with.
Dim cachedLogic As EmployeeLogic
cachedLogic = CType( e.ObjectInstance, EmployeeLogic)
' Test to determine whether the object already exists in the cache.
Dim temp As EmployeeLogic
temp = CType( Cache("ExpensiveEmployeeLogicObject"), EmployeeLogic)
If (temp Is Nothing) Then
' If it does not yet exist in the Cache, add it.
Cache.Insert("ExpensiveEmployeeLogicObject", cachedLogic)
End If
' Cancel the event, so that the object will
' not be Disposed if it implements IDisposable.
e.Cancel = True
End Sub ' ReturnEmployeeLogic
</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="GetCreateTime"
typename="Samples.AspNet.VB.EmployeeLogic"
onobjectcreating="GetEmployeeLogic"
onobjectdisposing="ReturnEmployeeLogic" >
</asp:objectdatasource>
</form>
</body>
</html>
Nell'esempio di codice seguente viene fornito l'oggetto business di livello intermedio di esempio usato dall'esempio di codice precedente. L'esempio di codice è costituito da un oggetto business di base, definito dalla classe, ovvero una classe con stato che incapsula la EmployeeLogic logica di business. Per un esempio di lavoro completo, è necessario compilare questo codice come libreria e usare queste classi da una pagina ASP.NET (.aspx file).
namespace Samples.AspNet.CS {
using System;
using System.Collections;
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 {
public EmployeeLogic () : this(DateTime.Now) {
}
public EmployeeLogic (DateTime creationTime) {
_creationTime = creationTime;
}
private DateTime _creationTime;
// Returns a collection of NorthwindEmployee objects.
public ICollection GetCreateTime () {
ArrayList al = new ArrayList();
// Returns creation time for this example.
al.Add("The business object that you are using was created at " + _creationTime);
return al;
}
}
}
Imports System.Collections
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace Samples.AspNet.VB
Public Class EmployeeLogic
Public Sub New()
MyClass.New(DateTime.Now)
End Sub
Public Sub New(ByVal creationTime As DateTime)
_creationTime = creationTime
End Sub
Private _creationTime As DateTime
' Returns a collection of NorthwindEmployee objects.
Public Function GetCreateTime() As ICollection
Dim al As New ArrayList()
' Returns creation time for this example.
al.Add("The business object that you are using was created at " + _creationTime)
Return al
End Function 'GetCreateTime
End Class
End Namespace ' Samples.AspNet.VB
Commenti
Se il metodo identificato per eseguire l'operazione di dati è static (Shared in Visual Basic), gli ObjectCreating eventi e ObjectCreated non vengono mai generati.
Il ObjectDataSource controllo chiama automaticamente il costruttore senza parametri di un oggetto business per crearne un'istanza usando la reflection. Gestire l'evento ObjectCreating per chiamare in modo esplicito un altro costruttore e impostare l'istanza dell'oggetto che genera la ObjectInstance proprietà dell'oggetto associato ObjectDataSourceEventArgs .
Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.
