QueryStringParameter Kelas

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.

Mengikat nilai bidang kueri-string permintaan HTTP ke objek parameter.

public ref class QueryStringParameter : System::Web::UI::WebControls::Parameter

public class QueryStringParameter : System.Web.UI.WebControls.Parameter

type QueryStringParameter = class
    inherit Parameter

Public Class QueryStringParameter
Inherits Parameter

Warisan: Object

Parameter
QueryStringParameter

Contoh

Contoh berikut menunjukkan cara membuat objek QueryStringParameter untuk digunakan sebagai filter saat Anda menampilkan data dalam kontrol GridView. Anda menambahkan objek QueryStringParameter ke koleksi AccessDataSource kontrol FilterParameters. Objek parameter mengikat nilai bidang string kueri bernama country ke string FilterExpression. Karena tidak ada properti DefaultValue yang ditentukan untuk parameter, jika tidak ada bidang bernama country yang diteruskan dengan string kueri, kontrol AccessDataSource melempar pengecualian NullReferenceException. Jika bidang bernama country diteruskan tetapi tidak memiliki nilai, kontrol GridView tidak menampilkan data.

<%@ 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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>
    </form>
  </body>
</html>

<%@ 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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>

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

Keterangan

Anda dapat menggunakan kelas QueryStringParameter untuk mengikat nilai bidang yang diteruskan sebagai bagian dari string kueri permintaan HTTP ke parameter yang digunakan dalam kueri atau perintah berparameter. Bidang diambil dari koleksi QueryString.

Kontrol yang mengikat data ke parameter mungkin melemparkan pengecualian jika objek QueryStringParameter direferensikan, tetapi tidak ada pasangan nama/nilai string kueri yang sesuai yang diteruskan. Demikian pula, mereka mungkin tidak menampilkan data jika nama bidang string kueri diteruskan tanpa nilai yang sesuai. Untuk menghindari situasi ini, atur properti DefaultValue jika sesuai.

Kelas QueryStringParameter menyediakan properti QueryStringField, yang mengidentifikasi nama nilai string kueri yang akan diikat. Ini juga menyediakan properti yang diwarisi dari kelas Parameter.

Important

Kelas QueryStringParameter tidak memvalidasi nilai yang diteruskan; memberikan nilai mentah. Namun, Anda dapat memvalidasi nilai objek QueryStringParameter dalam kontrol sumber data. Untuk melakukannya, tangani peristiwa Selecting, Updating, Inserting, atau Deleting kontrol sumber data dan periksa nilai parameter di penanganan aktivitas. Jika nilai parameter tidak lulus pengujian validasi, Anda dapat membatalkan operasi data dengan mengatur properti Cancel dari kelas CancelEventArgs terkait ke true.

Konstruktor

Nama	Deskripsi
QueryStringParameter()	Menginisialisasi instans kelas baru yang tidak disebutkan QueryStringParameter namanya.
QueryStringParameter(QueryStringParameter)	Menginisialisasi instans baru kelas QueryStringParameter, menggunakan nilai instans yang ditentukan oleh parameter `original`.
QueryStringParameter(String, DbType, String)	Menginisialisasi instans baru bernama dari kelas QueryStringParameter, menggunakan bidang string kueri yang ditentukan dan jenis data parameter.
QueryStringParameter(String, String)	Menginisialisasi instans bernama baru dari kelas QueryStringParameter, menggunakan string yang ditentukan untuk mengidentifikasi bidang string kueri mana yang akan diikat.
QueryStringParameter(String, TypeCode, String)	Menginisialisasi instans baru bernama dan ditik dengan kuat dari kelas QueryStringParameter, menggunakan string yang ditentukan untuk mengidentifikasi bidang string kueri mana yang akan diikat.

Properti

Nama	Deskripsi
ConvertEmptyStringToNull	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai yang Parameter terikat objek harus dikonversi ke `null` jika itu adalah Empty. (Diperoleh dari Parameter)
DbType	Mendapatkan atau mengatur jenis database parameter. (Diperoleh dari Parameter)
DefaultValue	Menentukan nilai default untuk parameter, jika nilai parameter terikat untuk tidak diinisialisasi saat metode dipanggil Evaluate(HttpContext, Control) . (Diperoleh dari Parameter)
Direction	Menunjukkan apakah Parameter objek digunakan untuk mengikat nilai ke kontrol, atau kontrol dapat digunakan untuk mengubah nilai. (Diperoleh dari Parameter)
IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah Parameter objek menyimpan perubahan pada status tampilannya. (Diperoleh dari Parameter)
Name	Mendapatkan atau mengatur nama parameter. (Diperoleh dari Parameter)
QueryStringField	Mendapatkan atau mengatur nama bidang string kueri yang diikat parameter.
Size	Mendapatkan atau mengatur ukuran parameter. (Diperoleh dari Parameter)
Type	Mendapatkan atau mengatur jenis parameter. (Diperoleh dari Parameter)
ValidateInput	Mendapatkan atau mengatur apakah nilai parameter string kueri sedang divalidasi atau tidak.
ViewState	Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status Parameter tampilan objek di beberapa permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Metode

Nama	Deskripsi
Clone()	Mengembalikan duplikat instans saat ini QueryStringParameter .
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Evaluate(HttpContext, Control)	Memperbarui dan mengembalikan nilai QueryStringParameter objek.
GetDatabaseType()	Mendapatkan nilai yang setara dengan jenis CLR instans DbType saat ini Parameter . (Diperoleh dari Parameter)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
LoadViewState(Object)	Memulihkan status tampilan sumber data yang sebelumnya disimpan. (Diperoleh dari Parameter)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnParameterChanged()	OnParametersChanged(EventArgs) Memanggil metode ParameterCollection koleksi yang berisi Parameter objek . (Diperoleh dari Parameter)
SaveViewState()	Menyimpan perubahan pada Parameter status tampilan objek sejak halaman diposting kembali ke server. (Diperoleh dari Parameter)
SetDirty()	Parameter Menandai objek sehingga statusnya akan direkam dalam status tampilan. (Diperoleh dari Parameter)
ToString()	Mengonversi nilai instans ini ke representasi string yang setara. (Diperoleh dari Parameter)
TrackViewState()	Parameter Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di objek kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
ICloneable.Clone()	Mengembalikan duplikat instans saat ini Parameter . (Diperoleh dari Parameter)
IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah Parameter objek menyimpan perubahan pada status tampilannya. (Diperoleh dari Parameter)
IStateManager.LoadViewState(Object)	Memulihkan status tampilan sumber data yang sebelumnya disimpan. (Diperoleh dari Parameter)
IStateManager.SaveViewState()	Menyimpan perubahan pada Parameter status tampilan objek sejak halaman diposting kembali ke server. (Diperoleh dari Parameter)
IStateManager.TrackViewState()	Parameter Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di objek kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?