ObjectDataSource.ObjectCreating Gebeurtenis
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Vindt plaats voordat het object dat wordt geïdentificeerd door de TypeName eigenschap wordt gemaakt.
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 Gebeurtenistype
Voorbeelden
Deze sectie bevat twee codevoorbeelden. In het eerste codevoorbeeld ziet u hoe u een ObjectDataSource object gebruikt met een zakelijk object en een GridView besturingselement om informatie weer te geven. Het tweede codevoorbeeld bevat het zakelijke object in de middelste laag dat wordt gebruikt in het eerste codevoorbeeld.
In het volgende codevoorbeeld ziet u hoe u een ObjectDataSource besturingselement gebruikt met een bedrijfsobject en een GridView besturingselement om informatie weer te geven. U kunt werken met een zakelijk object dat erg duur is om te maken (in termen van tijd of resources) voor elke gegevensbewerking die uw webpagina uitvoert. Een manier om met een duur object te werken, kan zijn om één keer een exemplaar van het object te maken en het vervolgens in de cache te plaatsen voor volgende bewerkingen in plaats van het te maken en te vernietigen voor elke gegevensbewerking.
Note
In een productietoepassing kunnen meerdere aanvragen tegelijkertijd gebruikmaken van hetzelfde exemplaar. Daarom moet het object op een thread-veilige manier worden geïmplementeerd.
In dit codevoorbeeld ziet u dit patroon. U kunt de ObjectCreating gebeurtenis afhandelen om eerst de cache voor een object te controleren en alleen een exemplaar van het object te maken als deze nog niet in de cache is opgeslagen. Voer vervolgens de gebeurtenis af om het bedrijfsobject in de ObjectDisposing cache te plaatsen voor toekomstig gebruik, in plaats van het te vernietigen. In dit codevoorbeeld wordt de eigenschap van het ObjectDataSourceDisposingEventArgs object ingesteld om true de CancelEventArgs.CancelObjectDataSource methode voor het niet aanroepen Dispose van het object te leiden.
<%@ 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>
Het volgende codevoorbeeld bevat het voorbeeld bedrijfsobject in de middelste laag dat in het voorgaande codevoorbeeld wordt gebruikt. Het codevoorbeeld bestaat uit een eenvoudig bedrijfsobject dat is gedefinieerd door de EmployeeLogic klasse. Dit is een stateful klasse die bedrijfslogica inkapselt. Voor een volledig werkend voorbeeld moet u deze code compileren als bibliotheek en deze klassen gebruiken vanaf een ASP.NET pagina (.aspx bestand).
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
Opmerkingen
Als de methode die is geïdentificeerd om de gegevensbewerking uit te voeren, static (Shared in Visual Basic), worden de gebeurtenissen ObjectCreating en ObjectCreated nooit gegenereerd.
Het ObjectDataSource besturingselement roept automatisch de parameterloze constructor van een bedrijfsobject aan om een exemplaar van het object te maken met behulp van weerspiegeling. Voer de ObjectCreating gebeurtenis uit om expliciet een andere constructor aan te roepen en stel het exemplaar van het object in dat resulteert in de ObjectInstance eigenschap van het gekoppelde ObjectDataSourceEventArgs object.
Zie Gebeurtenissen verwerken en genereren voor meer informatie over het afhandelen van gebeurtenissen.