ObjectDataSourceView.SelectMethod Properti
Definisi
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.
Mendapatkan atau mengatur nama metode atau fungsi yang ObjectDataSourceView dipanggil kontrol untuk mengambil data.
public:
property System::String ^ SelectMethod { System::String ^ get(); void set(System::String ^ value); };
public string SelectMethod { get; set; }
member this.SelectMethod : string with get, set
Public Property SelectMethod As String
Nilai Properti
String yang mewakili nama metode atau fungsi yang ObjectDataSourceView digunakan untuk mengambil data. Defaultnya adalah string kosong ("").
Contoh
Contoh kode berikut menunjukkan bagaimana GridView kontrol dapat menampilkan data menggunakan ObjectDataSource kontrol di halaman Formulir Web. ObjectDataSource Mengidentifikasi nama kelas yang sebagian atau sepenuhnya memenuhi syarat dengan propertinya TypeName dan metode yang dipanggil untuk mengambil data dengan propertinyaSelectMethod. Pada durasi, objek dibuat dan metode disebut menggunakan pantulan. GridView Kontrol menghitung melalui IEnumerable koleksi yang dikembalikan oleh SelectMethod, lalu menampilkan data.
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="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">
<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:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetAllEmployees"
typename="Samples.AspNet.CS.EmployeeLogic" />
</form>
</body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ObjectDataSource - Visual Basic Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<asp:gridview
id="GridView1"
runat="server"
datasourceid="ObjectDataSource1" />
<asp:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetAllEmployees"
typename="Samples.AspNet.VB.EmployeeLogic" />
</form>
</body>
</html>
Keterangan
Metode yang ditentukan dapat memiliki tanda tangan metode apa pun tetapi harus mengembalikan salah satu jenis yang tercantum dalam tabel berikut agar ObjectDataSource kontrol berhasil memanggilnya
Tipe hasil | Tindakan |
---|---|
IEnumerable | IEnumerable dikembalikan oleh Select metode . |
DataTable | DataView dibuat menggunakan DataTable dan dikembalikan oleh Select metode . |
DataSet | Yang pertama DataTableDataSet diekstraksi dan DataView dibuat dan dikembalikan oleh Select metode . |
Object | Objek dibungkus dalam satu elemen IEnumerable dan dikembalikan oleh Select metode . |
Metode yang diidentifikasi oleh SelectMethod properti dapat menjadi metode instans atau static
metode (Shared
dalam Visual Basic). Jika ini adalah metode instans, objek bisnis dibuat dan dihancurkan setiap kali metode dipanggil SelectMethod . Anda dapat menangani ObjectCreated peristiwa untuk bekerja dengan objek bisnis sebelum metode yang ditentukan oleh SelectMethod properti dipanggil. Anda juga dapat menangani ObjectDisposing peristiwa yang dimunculkan setelah metode yang ditentukan oleh SelectMethod properti dipanggil. (Dispose
dipanggil hanya jika objek bisnis mengimplementasikan IDisposable antarmuka.) Jika metodenya adalah static
metode (Shared
dalam Visual Basic), objek bisnis tidak pernah dibuat dan Anda tidak dapat menangani peristiwa ini.
Jika objek bisnis yang ObjectDataSource bekerja dengan kontrol menerapkan lebih dari satu metode atau fungsi dengan nama yang sama (metode kelebihan beban), kontrol sumber data mencoba memanggil yang benar sesuai dengan serangkaian kondisi, termasuk parameter dalam SelectParameters koleksi. Jika parameter dalam SelectParameters koleksi tidak cocok dengan tanda tangan metode yang ditentukan oleh SelectMethod properti , sumber data akan memberikan pengecualian.
Untuk informasi selengkapnya, lihat ObjectDataSource.SelectMethod.