ObjectDataSource.SelectParameters Properti

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.

Mendapatkan kumpulan parameter yang digunakan oleh metode yang ditentukan oleh SelectMethod properti .

public:
 property System::Web::UI::WebControls::ParameterCollection ^ SelectParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection SelectParameters { get; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.SelectParameters : System.Web.UI.WebControls.ParameterCollection

Public ReadOnly Property SelectParameters As ParameterCollection

Nilai Properti

ParameterCollection

Kumpulan parameter yang digunakan oleh metode yang ditentukan oleh SelectMethod properti .

Atribut: PersistenceModeAttribute

Contoh

Contoh kode berikut menunjukkan cara mengambil satu rekaman data menggunakan ObjectDataSource kontrol dan menampilkannya dalam DetailsView kontrol. ObjectDataSource Kontrol mengambil catatan karyawan tertentu dengan memanggil GetEmployee metode EmployeeLogic kelas . Metode ini GetEmployee memerlukan parameter ID karyawan. ObjectDataSource Kontrol menggunakan QueryStringParameter elemen dalam markup untuk membuat QueryStringParameter objek yang akan mengambil nilai parameter string kueri tertentu dari URL dan meneruskannya ke GetEmployee metode .

Kelas parameter lainnya dapat digunakan untuk mengambil nilai dari sumber lain, seperti properti kontrol, bidang formulir, cookie, ASP.NET data profil, atau status sesi. Anda juga dapat menggunakan objek parameter yang ditentukan dalam markup untuk meneruskan nilai yang dikodekan secara permanen ke metode pilih. Untuk informasi selengkapnya tentang kelas parameter yang tersedia, lihat Menggunakan Parameter dengan Kontrol Sumber Data untuk Pemfilteran.

Untuk menjalankan contoh ini, Anda memerlukan hal berikut:

Situs Web yang memiliki string koneksi bernama NorthwindConnection yang tersambung ke database Northwind Traders. Untuk informasi selengkapnya, lihat gambaran ObjectDataSource umum kelas.
Kelas EmployeeLogic yang ditampilkan sebagai salah satu contoh kode untuk ObjectDataSource ringkasan kelas. File kelas harus terletak di folder App_Code.
Kode sampel dapat dijalankan sebagai halaman .aspx. Jika Anda meminta halaman tanpa parameter string kueri, pesan kesalahan akan ditampilkan. Jika Anda meminta halaman menggunakan string kueri seperti ?empid=1 setelah nama file .aspx, Anda akan melihat detail untuk karyawan yang diminta.

<%@ 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:detailsview
          id="DetailsView1"
          runat="server"
          datasourceid="ObjectDataSource1">
        </asp:detailsview>

<!-- Security Note: The ObjectDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          typename="Samples.AspNet.CS.EmployeeLogic" >
          <selectparameters>
            <asp:querystringparameter name="EmployeeID" querystringfield="empid" defaultvalue="-1" />
          </selectparameters>
        </asp:objectdatasource>

    </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 - VB Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:detailsview
          id="DetailsView1"
          runat="server"
          datasourceid="ObjectDataSource1">
        </asp:detailsview>

<!-- Security Note: The ObjectDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          typename="Samples.AspNet.VB.EmployeeLogic" >
          <selectparameters>
            <asp:querystringparameter name="EmployeeID" querystringfield="empid" defaultvalue="-1" />
          </selectparameters>
        </asp:objectdatasource>

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

Keterangan

Properti SelectParameters mendapatkan SelectParameters properti objek ObjectDataSourceView yang terkait dengan ObjectDataSource kontrol.

Anda menambahkan parameter ke SelectParameters koleksi secara deklaratif dengan menggunakan SelectParameters elemen atau secara terprogram di handler untuk peristiwa tersebut Selecting . Pada durasi, parameter yang tercantum dalam SelectParameters elemen ditambahkan ke koleksi terlebih dahulu. Parameter dalam koleksi kemudian ditambahkan atau dihapus oleh handler untuk peristiwa tersebut Selecting . Peristiwa Selecting dinaikkan sebelum Select metode dijalankan.

Select Sebelum metode dijalankan, nama dan jenis parameter yang terkandung dalam SelectParameters koleksi harus cocok dengan tanda tangan metode yang ditentukan oleh SelectMethod properti . Misalnya, jika metode pilih bernama GetEmployeesByStateAndAge mengambil string bilangan bulat dan sebagai parameter, SelectParameters koleksi harus berisi dua parameter. Parameter pertama harus diselesaikan ke string dan parameter kedua harus diselesaikan ke bilangan bulat. Kedua parameter dapat ditentukan dalam markup dalam SelectParameters elemen . Atau, mereka dapat ditambahkan di Selecting penanganan aktivitas, atau satu parameter dapat ditambahkan dalam markup dan yang lain dapat ditambahkan secara terprogram.

Untuk informasi selengkapnya, lihat Menggunakan Parameter dengan ObjectDataSource Control dan SelectMethod properti .

Penting

Dalam kode untuk Selecting penanganan aktivitas atau dalam metode yang ditentukan oleh SelectMethod properti , pastikan Anda memvalidasi nilai parameter apa pun yang diterima dari klien.

Berlaku untuk

Bagikan melalui