ObjectDataSource.ObjectDisposing Esemény
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
A tulajdonság által TypeName azonosított objektum elvetése előtt történik.
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 Eseménytípus
Példák
Ez a szakasz két példakódot tartalmaz. Az első példakód bemutatja, hogyan használható egy ObjectDataSource objektum egy üzleti objektummal és egy vezérlővel GridView az információk megjelenítéséhez. A második példakód az első kód példában használt középső szintű üzleti objektumot tartalmazza.
Az alábbi példakód bemutatja, hogyan használható egy ObjectDataSource vezérlő egy üzleti objektummal és egy vezérlővel GridView az információk megjelenítéséhez. Előfordulhat, hogy olyan üzleti objektummal dolgozik, amely (idő vagy erőforrások tekintetében) nagyon költséges minden olyan adatművelethez, amelyet a weblap hajt végre. A drága objektumok egyik módja lehet egy példány létrehozása, majd gyorsítótárazása a későbbi műveletekhez ahelyett, hogy minden adatművelethez létrehozna és megsemmisíteni. Ez a példa ezt a mintát mutatja be. Az eseményt úgy kezelheti ObjectCreating , hogy először ellenőrizze az objektum gyorsítótárát, és csak akkor hozzon létre egy példányt, ha még nincs gyorsítótárazva. Ezután kezelje az eseményt az ObjectDisposing üzleti objektum későbbi használatra való gyorsítótárazásához ahelyett, hogy megsemmisíti azt. Ebben a kód példában az CancelEventArgs.CancelObjectDataSourceDisposingEventArgs objektum tulajdonsága úgy van beállítva, hogy true az ObjectDataSource ne hívja meg a metódust az Dispose objektumon.
<%@ 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>
Az alábbi példakód a példa középszintű üzleti objektumot tartalmazza, amelyet az előző kód példája használ. A példakód egy alapszintű üzleti objektumból áll, amelyet az EmployeeLogic osztály határoz meg, amely egy állapotalapú osztály, amely az üzleti logikát foglalja magában. A teljes munka példához ezt a kódot kódtárként kell lefordítania, és ezeket az osztályokat egy ASP.NET lapról (.aspx fájlból) kell használnia.
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
Az alábbi példa bemutatja, hogyan kezelheti az ObjectDisposing eseményt egy ObjectDataSource LINQ-ból SQL-osztályba tartozó vezérlőelem használatakor.
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;
}
Megjegyzések
Az ObjectDisposing esemény mindig az üzleti objektum példányának elvetése előtt jön létre. Ha az üzleti objektum implementálja az IDisposable interfészt, a metódus az Dispose esemény létrehozása után lesz meghívva.
Kezelje az eseményt ObjectDisposing az objektum egyéb metódusainak meghívásához, tulajdonságok beállításához vagy az objektumra jellemző tisztítás végrehajtásához az objektum megsemmisítése előtt. Az objektumra mutató hivatkozást az ObjectInstance objektum által ObjectDataSourceEventArgs közzétett tulajdonság éri el.
Ha LINQ-t tartalmazó vezérlőt használ ObjectDataSource az SQL-osztályhoz, meg kell szakítania az adatkörnyezeti osztály eltávolítását az ObjectDisposing esemény kezelőjében. Erre a lépésre azért van szükség, mert az SQL-hez irányuló LINQ támogatja a halasztott végrehajtást, míg a ObjectDataSource vezérlő megpróbálja megsemmisíteni az adatkörnyezetet a Kiválasztás művelet után.
Az események kezelésével kapcsolatos további információkért lásd: Események kezelése és emelése.
