ObjectDataSource.ObjectCreating 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 létrehozása előtt következik be.
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 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.
Note
Éles alkalmazásokban előfordulhat, hogy egyszerre több kérés is ugyanazt a példányt használja. Ezért az objektumot szálbiztos módon kell megvalósítani.
Ez a példakód ezt a mintát mutatja be. Az eseményt úgy ObjectCreating kezelheti, hogy először ellenőrizze az objektum gyorsítótárát, és csak akkor hozza létre az objektum egy példányát, 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 a true nem hívható ObjectDataSource metódust irányítsa Dispose az 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
Megjegyzések
Ha az adatművelet végrehajtásához azonosított módszer static (Shared Visual Basic), a ObjectCreating és ObjectCreated események soha nem kerülnek elő.
A ObjectDataSource vezérlő automatikusan meghívja egy üzleti objektum paraméter nélküli konstruktorát, hogy tükrözés használatával hozzon létre egy példányt. Kezelje az eseményt ObjectCreating , hogy explicit módon meghívjon egy másik konstruktort, és állítsa be az objektum azon példányát, amely a ObjectInstance társított ObjectDataSourceEventArgs objektum tulajdonságát eredményezi.
Az események kezelésével kapcsolatos további információkért lásd: Események kezelése és emelése.
