ObjectDataSourceEventArgs 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 ObjectCreating peristiwa ObjectDataSource dan ObjectCreated kontrol.

public ref class ObjectDataSourceEventArgs : EventArgs

public class ObjectDataSourceEventArgs : EventArgs

type ObjectDataSourceEventArgs = class
    inherit EventArgs

Public Class ObjectDataSourceEventArgs
Inherits EventArgs

Warisan: Object

EventArgs
ObjectDataSourceEventArgs

Contoh

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

Contoh kode berikut menunjukkan cara menggunakan ObjectDataSource kontrol dengan objek bisnis dan GridView kontrol untuk mengambil dan menampilkan informasi. Dalam contoh ini, seperti dalam banyak skenario dunia nyata, mungkin tidak mungkin atau sesuai untuk menggunakan instans default objek bisnis dengan ObjectDataSource kontrol. Dalam contoh ini, ObjectDataSource tidak berhasil memanggil konstruktor tanpa parameter karena akan melemparkan pengecualian. Dalam beberapa kasus, konstruktor tanpa parameter mungkin dilindungi dan di kasus lain mungkin tidak menginisialisasi objek bisnis ke status yang diinginkan. Apa pun alasannya, Anda dapat membuat instans objek bisnis sendiri dan mengatur instans ke ObjectInstance properti ObjectDataSourceEventArgs objek yang diteruskan ke handler. Ini adalah instans objek bisnis yang ObjectDataSource akan digunakan untuk melakukan pekerjaannya.

<%@ 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">
private void NorthwindLogicCreating(object sender, ObjectDataSourceEventArgs e)
{
    // Create an instance of the business object using a non-default constructor.
    EmployeeLogic eLogic = new EmployeeLogic("Not created by the default constructor!");
    
    // Set the ObjectInstance property so that the ObjectDataSource uses the created instance.
    e.ObjectInstance = eLogic;
}

</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="GetAllEmployees"
          onobjectcreating="NorthwindLogicCreating"
          typename="Samples.AspNet.CS.EmployeeLogic" >
        </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">
Private Sub NorthwindLogicCreating(sender As Object, e As ObjectDataSourceEventArgs)

    ' Create an instance of the business object using a non-default constructor.
    Dim eLogic As EmployeeLogic = New EmployeeLogic("Not created by the default constructor!")
    
    ' Set the ObjectInstance property so that the ObjectDataSource uses the created instance.
    e.ObjectInstance = eLogic
    
End Sub ' NorthwindLogicCreating

</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="GetAllEmployees"
          onobjectcreating="NorthwindLogicCreating"
          typename="Samples.AspNet.VB.EmployeeLogic" >
        </asp:objectdatasource>

    </form>
  </body>
</html>

Contoh kode berikut menunjukkan contoh objek bisnis dasar yang digunakan contoh kode sebelumnya.

namespace Samples.AspNet.CS {

using System;
using System.Collections;
using System.Web.UI;
using System.Web.UI.WebControls;

  public class EmployeeLogic {

    public EmployeeLogic() {  
        throw new NotSupportedException("Initialize data.");
    }
    
    public EmployeeLogic(string data) {
        _data = data;
    }

    private string _data;
    
    // Returns a collection of NorthwindEmployee objects.
    public ICollection GetAllEmployees () {
      ArrayList al = new ArrayList();      
      al.Add(_data);        
      return al;
    }
  }
}

Imports System.Collections
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB
  Public Class EmployeeLogic
    
    
    Public Sub New() 
        Throw New NotSupportedException("Initialize data.")
    
    End Sub
    
    
    Public Sub New(ByVal data As String) 
        _data = data
    
    End Sub
    
    Private _data As String
    
    
    ' Returns a collection of NorthwindEmployee objects.
    Public Function GetAllEmployees() As ICollection 
        Dim al As New ArrayList()
        al.Add(_data)
        Return al
    
    End Function 'GetAllEmployees
  End Class
End Namespace ' Samples.AspNet.VB

Keterangan

Kelas ObjectDataSourceEventArgs digunakan dalam OnObjectCreating metode dan OnObjectCreated untuk menyediakan akses ke instans objek bisnis sebelum operasi data apa pun yang menggunakan ObjectDataSource kontrol dan objek bisnis dilakukan. Objek bisnis diatur dan diakses menggunakan ObjectInstance properti . Dengan menambahkan delegasi penanganan aktivitas untuk menangani ObjectCreating peristiwa, Anda dapat membuat instans objek bisnis dalam kode kustom alih-alih ObjectDataSource melakukan instans. Ini berguna ketika Anda menginginkan instans non-default objek bisnis Anda atau memanggil konstruktor non-parameterless untuk membuat instans; ObjectDataSource selalu memanggil konstruktor tanpa parameter untuk membuat instans objek bisnis yang bekerja dengannya. Anda juga dapat menambahkan delegasi penanganan aktivitas untuk menangani ObjectCreated peristiwa, yang memungkinkan Anda mengakses anggota objek bisnis yang diekspos secara publik untuk melakukan inisialisasi atau pekerjaan tambahan apa pun.

Metode OnObjectCreating dan OnObjectCreated tidak dipanggil oleh ObjectDataSource kontrol, jika metode objek bisnis yang melakukan operasi data adalah static.

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, Deleted. Terjadi setelah operasi sisipkan, perbarui, atau hapus selesai.	ObjectDataSourceStatusEventArgs	ObjectDataSourceStatusEventHandler
ObjectDisposing. Terjadi sebelum objek bisnis dihancurkan.	ObjectDataSourceDisposingEventArgs	ObjectDataSourceDisposingEventHandler

Konstruktor

ObjectDataSourceEventArgs(Object)

Menginisialisasi instans ObjectDataSourceEventArgs baru kelas menggunakan objek yang ditentukan.

Properti

ObjectInstance

Mendapatkan atau mengatur 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

Lihat juga

ObjectDataSourceObjectEventHandler

Bagikan melalui