ObjectDataSourceDisposingEventArgs Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menyediakan data untuk ObjectDisposing peristiwa ObjectDataSource kontrol.

public ref class ObjectDataSourceDisposingEventArgs : System::ComponentModel::CancelEventArgs

public class ObjectDataSourceDisposingEventArgs : System.ComponentModel.CancelEventArgs

type ObjectDataSourceDisposingEventArgs = class
    inherit CancelEventArgs

Public Class ObjectDataSourceDisposingEventArgs
Inherits CancelEventArgs

Warisan: Object

EventArgs

CancelEventArgs
ObjectDataSourceDisposingEventArgs

Contoh

Bagian ini berisi dua contoh kode. Contoh kode pertama menunjukkan cara menggunakan ObjectDataSource kontrol dengan objek bisnis dan GridView kontrol untuk menampilkan informasi. Contoh kode kedua menyediakan contoh objek bisnis tingkat menengah yang digunakan contoh kode pertama.

Contoh kode berikut menunjukkan cara menggunakan ObjectDataSource kontrol dengan objek bisnis dan GridView kontrol untuk menampilkan informasi. Anda mungkin bekerja dengan objek bisnis yang sangat mahal (dalam hal waktu atau sumber daya) untuk membuat setiap operasi data yang dilakukan halaman Web Anda. Salah satu cara untuk bekerja dengan objek mahal mungkin adalah dengan membuat instansnya sekali, dan kemudian menyimpannya untuk operasi berikutnya alih-alih membuat dan menghancurkannya untuk setiap operasi data. Contoh ini menunjukkan pola ini. Anda dapat menangani ObjectCreating peristiwa untuk memeriksa cache untuk objek terlebih dahulu, lalu membuat instans, hanya jika satu belum di-cache. Kemudian, tangani ObjectDisposing peristiwa untuk menyimpan objek bisnis untuk digunakan di masa mendatang, alih-alih menghancurkannya. Dalam contoh ini, CancelEventArgs.Cancel properti ObjectDataSourceDisposingEventArgs objek diatur ke true, untuk mengarahkan ObjectDataSource agar tidak memanggil Dispose metode pada instans.

<%@ 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>

Contoh kode berikut menyediakan contoh objek bisnis tingkat menengah yang digunakan contoh kode sebelumnya. Contoh kode terdiri dari objek bisnis dasar, yang ditentukan oleh EmployeeLogic kelas , yang merupakan kelas yang mempertahankan status dan merangkum logika bisnis. Untuk contoh kerja lengkap, Anda harus mengkompilasi kode ini sebagai pustaka, lalu menggunakan kelas ini dari halaman ASP.

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

Keterangan

Kelas ObjectDataSourceDisposingEventArgs digunakan dalam OnObjectDisposing metode untuk menyediakan akses ke instans objek bisnis setelah operasi data apa pun yang menggunakan ObjectDataSource kontrol dan objek bisnis dilakukan, tetapi sebelum objek bisnis dihancurkan. Objek bisnis diakses menggunakan ObjectInstance properti . Dengan menambahkan delegasi untuk menangani ObjectDisposing acara, Anda dapat mengakses anggota objek bisnis yang diekspos secara publik untuk melakukan pekerjaan akhir atau pembersihan.

Metode OnObjectDisposing ini tidak dipanggil oleh ObjectDataSource kontrol, jika metode yang melakukan operasi data adalah static metode . Tidak ada instans objek bisnis yang dibuat ketika metode statis.

Kontrol ini ObjectDataSource memaparkan banyak peristiwa yang dapat Anda tangani untuk bekerja dengan objek bisnis yang mendasar pada berbagai waktu dalam siklus hidupnya. Tabel berikut mencantumkan peristiwa dan kelas terkait EventArgs serta delegasi penanganan aktivitas.

Kejadian	EventArgs	EventHandler
ObjectCreating. Terjadi segera sebelum instans objek bisnis dibuat.	ObjectDataSourceEventArgs	ObjectDataSourceObjectEventHandler
ObjectCreated. Terjadi segera setelah instans objek bisnis dibuat.	ObjectDataSourceEventArgs	ObjectDataSourceObjectEventHandler
Selecting. Terjadi sebelum data diambil.	ObjectDataSourceSelectingEventArgs	ObjectDataSourceSelectingEventHandler
Inserting, Updating, dan Deleting. Terjadi sebelum operasi sisipkan, perbarui, atau hapus dilakukan.	ObjectDataSourceMethodEventArgs	ObjectDataSourceMethodEventHandler
Selected Terjadi setelah data diambil.	ObjectDataSourceStatusEventArgs	ObjectDataSourceStatusEventHandler
Inserted, Updated, dan Deleted. Terjadi setelah operasi sisipkan, perbarui, atau hapus selesai.	ObjectDataSourceStatusEventArgs	ObjectDataSourceStatusEventHandler
ObjectDisposing. Terjadi sebelum objek bisnis dihancurkan.	ObjectDataSourceDisposingEventArgs	ObjectDataSourceDisposingEventHandler

Konstruktor

ObjectDataSourceDisposingEventArgs(Object)

Menginisialisasi instans ObjectDataSourceDisposingEventArgs baru kelas menggunakan objek yang ditentukan.

Properti

Cancel	Mendapatkan atau menetapkan nilai yang menunjukkan apakah acara harus dibatalkan. (Diperoleh dari CancelEventArgs)
ObjectInstance	Mendapatkan objek yang mewakili objek bisnis tempat ObjectDataSource kontrol melakukan operasi data.

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk

Bagikan melalui