QueryStringParameter.QueryStringField Properti

Definisi

Ruang nama:

System.Web.UI.WebControls

Rakitan:

System.Web.dll

Mendapatkan atau mengatur nama bidang string kueri yang diikat parameter.

public:
 property System::String ^ QueryStringField { System::String ^ get(); void set(System::String ^ value); };

public string QueryStringField { get; set; }

member this.QueryStringField : string with get, set

Public Property QueryStringField As String

Nilai Properti

String

Nama bidang string kueri yang diikat parameter.

Contoh

Contoh berikut menunjukkan cara menggunakan QueryStringParameter objek bersama dengan SqlDataSource kontrol untuk menampilkan data dalam ListBox kontrol. QueryStringField Properti diatur ke nama bidang query-string yang diharapkan, dan parameter ditambahkan ke SelectParameters koleksi. Properti DefaultValue disediakan jika pasangan nama/nilai tidak diteruskan dengan string kueri.

      <asp:ListBox
        id ="ListBox1"
        runat="server"
        DataSourceID="SqlDataSource1"
        DataValueField="EmployeeID"
        DataTextField="LastName" />
    
<!-- Use a query string that includes empId=1 -->
    
<!-- Security Note: The SqlDataSource 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:SqlDataSource
        id="SqlDataSource1"
        runat="server"
        ConnectionString="<%$ ConnectionStrings:MyNorthwind %>"
        SelectCommand="Select EmployeeID, LastName From Employees where EmployeeID = @empId">
        <SelectParameters>
          <asp:QueryStringParameter Name="empId" QueryStringField="empId" />
        </SelectParameters>
      </asp:SqlDataSource>

      <asp:ListBox
        id ="ListBox1"
        runat="server"
        DataSourceID="SqlDataSource1"
        DataValueField="EmployeeID"
        DataTextField="LastName" />

<!-- Use a query string that includes empId=1 -->

<!-- Security Note: The SqlDataSource 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:SqlDataSource
        id="SqlDataSource1"
        runat="server"
        ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
        SelectCommand="Select EmployeeID, LastName From Employees where EmployeeID = @empId">
        <SelectParameters>
          <asp:QueryStringParameter     Name="empId" QueryStringField="empId" />
        </SelectParameters>
      </asp:SqlDataSource>

Contoh berikut menunjukkan cara menggunakan QueryStringParameter objek bersama dengan SqlDataSource kontrol untuk menampilkan data dalam GridView kontrol. Objek QueryStringParameter ditambahkan ke SelectParameters koleksi, bersama dengan objek parameter lain yang digunakan untuk parameter output dan mengembalikan nilai. Untuk mengambil data, tangani nilai yang dikembalikan dari prosedur tersimpan. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk SqlDataSourceStatusEventArgs kelas .

<asp:sqldatasource
    id="SqlDataSource1"
    runat="server"
    datasourcemode="DataSet"
    connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
    selectcommand="getordertotal"
    onselected="OnSelectedHandler">
    <selectparameters>
      <asp:querystringparameter name="empId" querystringfield="empId" />
      <asp:parameter name="total" type="Int32" direction="Output" defaultvalue="0" />
      <asp:parameter name="_ret" type="Int32" direction="ReturnValue" defaultvalue="0" />
    </selectparameters>
</asp:sqldatasource>

<asp:sqldatasource
    id="SqlDataSource1"
    runat="server"
    datasourcemode="DataSet"
    connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
    selectcommand="getordertotal"
    onselected="OnSelectedHandler">
    <selectparameters>
      <asp:querystringparameter name="empId" querystringfield="empId" />
      <asp:parameter name="total" type="Int32" direction="Output" defaultvalue="0" />
      <asp:parameter name="_ret" type="Int32" direction="ReturnValue" defaultvalue="0" />
    </selectparameters>
</asp:sqldatasource>

Keterangan

Properti QueryStringField mengidentifikasi pasangan nama/nilai yang diteruskan dengan string kueri. Properti QueryStringField mengidentifikasi nama pasangan, sedangkan QueryStringParameter properti mengikat ke nilai yang sesuai pada waktu proses. Jika pasangan nama/nilai string kueri yang diharapkan tidak diteruskan ke halaman dengan string kueri, metode kemudian Evaluate mencoba mengikat parameter ke nilai DefaultValue properti. DefaultValue Jika properti tidak diatur, Evaluate metode gagal mengikat parameter ke nilai.