QueryStringParameter 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.

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 FilterParameters kontrol AccessDataSource. 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.

Penting

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

QueryStringParameter()	Menginisialisasi instans baru yang tidak disebutkan namanya dari kelas QueryStringParameter.
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

ConvertEmptyStringToNull	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai yang terikat objek Parameter harus dikonversi ke `null` jika 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 Evaluate(HttpContext, Control) dipanggil. (Diperoleh dari Parameter)
Direction	Menunjukkan apakah objek Parameter digunakan untuk mengikat nilai ke kontrol, atau kontrol dapat digunakan untuk mengubah nilai. (Diperoleh dari Parameter)
IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah objek Parameter 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 tampilan objek Parameter di beberapa permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Metode

Clone()	Mengembalikan duplikat instans QueryStringParameter saat ini.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Evaluate(HttpContext, Control)	Memperbarui dan mengembalikan nilai objek QueryStringParameter.
GetDatabaseType()	Mendapatkan nilai DbType yang setara dengan jenis CLR instans Parameter saat ini. (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()	Memanggil metode OnParametersChanged(EventArgs) koleksi ParameterCollection yang berisi objek Parameter. (Diperoleh dari Parameter)
SaveViewState()	Menyimpan perubahan ke status tampilan objek Parameter sejak halaman diposting kembali ke server. (Diperoleh dari Parameter)
SetDirty()	Menandai objek Parameter sehingga statusnya akan direkam dalam status tampilan. (Diperoleh dari Parameter)
ToString()	Mengonversi nilai instans ini ke representasi string yang setara. (Diperoleh dari Parameter)
TrackViewState()	Menyebabkan objek Parameter melacak perubahan pada status tampilannya sehingga dapat disimpan dalam objek ViewState kontrol dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Implementasi Antarmuka Eksplisit

ICloneable.Clone()	Mengembalikan duplikat instans Parameter saat ini. (Diperoleh dari Parameter)
IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah objek Parameter 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 ke status tampilan objek Parameter sejak halaman diposting kembali ke server. (Diperoleh dari Parameter)
IStateManager.TrackViewState()	Menyebabkan objek Parameter melacak perubahan pada status tampilannya sehingga dapat disimpan dalam objek ViewState kontrol dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Berlaku untuk

Bagikan melalui