ObjectDataSource.ObjectDisposing 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 dell'eliminazione dell'oggetto identificato dalla proprietà TypeName.
public:
event System::Web::UI::WebControls::ObjectDataSourceDisposingEventHandler ^ ObjectDisposing;public event System.Web.UI.WebControls.ObjectDataSourceDisposingEventHandler ObjectDisposing;member this.ObjectDisposing : System.Web.UI.WebControls.ObjectDataSourceDisposingEventHandler Public Custom Event ObjectDisposing As ObjectDataSourceDisposingEventHandler Tipo evento
Esempio
In questa sezione sono riportati due esempi di codice. Nel primo esempio di codice viene illustrato come utilizzare un ObjectDataSource oggetto con un 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 utilizzare un ObjectDataSource controllo con un oggetto business e un GridView controllo per visualizzare le informazioni. È possibile usare un oggetto business molto costoso da creare (in termini di tempo o risorse) per ogni operazione di dati eseguita dalla pagina Web. Un modo per lavorare con un oggetto costoso potrebbe essere creare un'istanza di tale oggetto una sola volta e quindi memorizzarlo nella cache per le operazioni successive anziché crearlo ed eliminarlo per ogni operazione di dati. In questo esempio viene illustrato questo modello. È possibile gestire l'evento ObjectCreating per controllare prima la cache di un oggetto e crearne solo un'istanza, se non ne è già memorizzata nella cache. Gestire quindi l'evento per memorizzare nella ObjectDisposing cache l'oggetto business per un uso futuro, anziché eliminarlo. In questo esempio di codice la CancelEventArgs.Cancel proprietà dell'oggetto ObjectDataSourceDisposingEventArgs è impostata su per true indirizzare a ObjectDataSource per non chiamare il Dispose 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 EmployeeLogic classe , che è una classe con stato che incapsula la logica di business. Per un esempio funzionante completo, è necessario compilare questo codice come libreria e usare queste classi da una pagina di 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
Nell'esempio seguente viene illustrato come gestire l'evento ObjectDisposing quando si usa un ObjectDataSource controllo con una classe LINQ to SQL.
Public Sub ExampleObjectDisposing(ByVal sender As Object, _
ByVal e As ObjectDataSourceDisposingEventArgs)
e.Cancel = True
End Sub
public void ExampleObjectDisposing(object sender,
ObjectDataSourceDisposingEventArgs e)
{
e.Cancel = true;
}
Commenti
L'evento ObjectDisposing viene sempre generato prima che l'istanza dell'oggetto business venga rimossa. Se l'oggetto business implementa l'interfaccia IDisposable , il Dispose metodo viene chiamato dopo la generazione di questo evento.
Gestire l'evento ObjectDisposing per chiamare altri metodi sull'oggetto, impostare le proprietà o eseguire la pulizia specifica dell'oggetto prima che l'oggetto venga eliminato definitivamente. Un riferimento all'oggetto è accessibile dalla ObjectInstance proprietà , esposta dall'oggetto ObjectDataSourceEventArgs .
Quando si usa un ObjectDataSource controllo con una classe LINQ to SQL, è necessario annullare l'eliminazione della classe del contesto dati in un gestore per l'evento ObjectDisposing . Questo passaggio è necessario perché LINQ to SQL supporta l'esecuzione posticipata, mentre il ObjectDataSource controllo tenta di eliminare il contesto dei dati dopo l'operazione Select.
Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.
