ObjectDataSource.ObjectDisposing Händelse
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Inträffar innan objektet som identifieras av egenskapen TypeName tas bort.
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 Händelsetyp
Exempel
Det här avsnittet innehåller två kodexempel. Det första kodexemplet visar hur du använder ett ObjectDataSource objekt med ett affärsobjekt och en GridView kontroll för att visa information. Det andra kodexemplet innehåller det mellannivåobjekt som används i det första kodexemplet.
Följande kodexempel visar hur du använder en ObjectDataSource kontroll med ett affärsobjekt och en GridView kontroll för att visa information. Du kan arbeta med ett affärsobjekt som är mycket dyrt att skapa (när det gäller tid eller resurser) för varje dataåtgärd som webbsidan utför. Ett sätt att arbeta med ett dyrt objekt kan vara att skapa en instans av den en gång och sedan cachelagra den för efterföljande åtgärder i stället för att skapa och förstöra den för varje dataåtgärd. Det här exemplet visar det här mönstret. Du kan hantera ObjectCreating händelsen för att kontrollera cachen för ett objekt först och bara skapa en instans av den, om en inte redan har cachelagrats.
ObjectDisposing Hantera sedan händelsen för att cachelagrar affärsobjektet för framtida användning, i stället för att förstöra det. I det här kodexemplet CancelEventArgs.Cancel är egenskapen för ObjectDataSourceDisposingEventArgs objektet inställd på att true dirigera ObjectDataSource till att inte anropa Dispose -metoden för objektet.
<%@ 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>
Följande kodexempel innehåller det exempel på affärsobjekt på mellannivå som används i föregående kodexempel. Kodexemplet består av ett grundläggande affärsobjekt som definieras av EmployeeLogic klassen, vilket är en tillståndskänslig klass som kapslar in affärslogik. För ett fullständigt fungerande exempel måste du kompilera den här koden som ett bibliotek och använda dessa klasser från en ASP.NET sida (.aspx fil).
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
I följande exempel visas hur du hanterar ObjectDisposing händelsen när du använder en ObjectDataSource kontroll med en LINQ till SQL-klass.
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;
}
Kommentarer
Händelsen ObjectDisposing aktiveras alltid innan instansen av affärsobjektet tas bort. Om affärsobjektet implementerar gränssnittet IDisposable anropas Dispose metoden efter att den här händelsen har genererats.
ObjectDisposing Hantera händelsen för att anropa andra metoder för objektet, ange egenskaper eller utföra rensning som är specifik för objektet innan objektet förstörs. En referens till objektet nås av ObjectInstance egenskapen, som exponeras av ObjectDataSourceEventArgs objektet.
När du använder en ObjectDataSource kontroll med en LINQ till SQL-klass måste du avbryta disponering av datakontextklassen i en hanterare för ObjectDisposing händelsen. Det här steget är nödvändigt eftersom LINQ till SQL stöder uppskjuten ObjectDataSource körning, medan kontrollen försöker ta bort datakontexten efter åtgärden Välj.
Mer information om hur du hanterar händelser finns i Hantera och höja händelser.
