QueryStringParameter Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wiąże wartość pola ciągu zapytania żądania HTTP z obiektem parametru.

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

Dziedziczenie: Object

Parameter
QueryStringParameter

Przykłady

W poniższym przykładzie pokazano, jak utworzyć obiekt QueryStringParameter do użycia jako filtr podczas wyświetlania danych w kontrolce GridView. Obiekt QueryStringParameter można dodać do kolekcji FilterParameters kontrolki AccessDataSource. Obiekt parametru wiąże wartość pola ciągu zapytania o nazwie country z jego ciągiem FilterExpression. Ponieważ dla parametru nie określono żadnej właściwości DefaultValue, jeśli żadne pole o nazwie country nie zostanie przekazane z ciągiem zapytania, kontrolka AccessDataSource zgłasza wyjątek NullReferenceException. Jeśli pole o nazwie country jest przekazywane, ale nie ma wartości, kontrolka GridView nie wyświetla żadnych danych.

<%@ 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>

Uwagi

Możesz użyć klasy QueryStringParameter, aby powiązać wartość pola, które jest przekazywane jako część ciągu zapytania żądania HTTP do parametru używanego w sparametryzowanym zapytaniu lub poleceniu. Pole jest pobierane z kolekcji QueryString.

Kontrolki, które wiążą dane z parametrem, mogą zgłaszać wyjątek, jeśli obiekt QueryStringParameter jest przywoływane, ale nie jest przekazywana żadna odpowiadająca mu para nazwa/wartość ciągu zapytania. Podobnie mogą nie wyświetlać żadnych danych, jeśli nazwa pola ciągu zapytania jest przekazywana bez odpowiedniej wartości. Aby uniknąć tych sytuacji, ustaw właściwość DefaultValue tam, gdzie jest to konieczne.

Klasa QueryStringParameter udostępnia właściwość QueryStringField, która identyfikuje nazwę wartości ciągu zapytania, z którą ma być powiązana. Udostępnia również właściwości dziedziczone z klasy Parameter.

Ważny

Klasa QueryStringParameter nie weryfikuje przekazanej wartości; udostępnia wartość nieprzetworzona. Można jednak zweryfikować wartość obiektu QueryStringParameter w kontrolce źródła danych. W tym celu obsłuż Selecting, Updating, Insertinglub Deleting zdarzenie kontroli źródła danych i sprawdź wartość parametru w procedurze obsługi zdarzeń. Jeśli wartość parametru nie przejdzie testów walidacji, możesz anulować operację danych, ustawiając właściwość Cancel skojarzonej klasy CancelEventArgs na true.

Konstruktory

QueryStringParameter()	Inicjuje nowe nienazwane wystąpienie klasy QueryStringParameter.
QueryStringParameter(QueryStringParameter)	Inicjuje nowe wystąpienie klasy QueryStringParameter przy użyciu wartości wystąpienia określonego przez parametr `original`.
QueryStringParameter(String, DbType, String)	Inicjuje nowe nazwane wystąpienie klasy QueryStringParameter przy użyciu określonego pola ciągu zapytania i typu danych parametru.
QueryStringParameter(String, String)	Inicjuje nowe nazwane wystąpienie klasy QueryStringParameter przy użyciu określonego ciągu w celu zidentyfikowania pola ciągu zapytania, z którym ma być powiązane.
QueryStringParameter(String, TypeCode, String)	Inicjuje nowe nazwane i silnie typizowane wystąpienie klasy QueryStringParameter przy użyciu określonego ciągu w celu zidentyfikowania pola ciągu zapytania, z którym ma być powiązane.

Właściwości

ConvertEmptyStringToNull	Pobiera lub ustawia wartość wskazującą, czy wartość, z którą jest powiązany obiekt Parameter, powinna zostać przekonwertowana na `null`, jeśli jest Empty. (Odziedziczone po Parameter)
DbType	Pobiera lub ustawia typ bazy danych parametru. (Odziedziczone po Parameter)
DefaultValue	Określa wartość domyślną parametru, jeśli wartość parametru jest powiązana z niezainicjowanym, gdy wywoływana jest metoda Evaluate(HttpContext, Control). (Odziedziczone po Parameter)
Direction	Wskazuje, czy obiekt Parameter jest używany do powiązania wartości z kontrolką, czy kontrolki można użyć do zmiany wartości. (Odziedziczone po Parameter)
IsTrackingViewState	Pobiera wartość wskazującą, czy obiekt Parameter zapisuje zmiany w stanie widoku. (Odziedziczone po Parameter)
Name	Pobiera lub ustawia nazwę parametru. (Odziedziczone po Parameter)
QueryStringField	Pobiera lub ustawia nazwę pola ciągu zapytania, z którą jest powiązany parametr.
Size	Pobiera lub ustawia rozmiar parametru. (Odziedziczone po Parameter)
Type	Pobiera lub ustawia typ parametru. (Odziedziczone po Parameter)
ValidateInput	Pobiera lub ustawia, czy wartość parametru ciągu zapytania jest weryfikowana, czy nie.
ViewState	Pobiera słownik informacji o stanie, który umożliwia zapisywanie i przywracanie stanu widoku obiektu Parameter na wielu żądaniach dla tej samej strony. (Odziedziczone po Parameter)

Metody

Clone()	Zwraca duplikat bieżącego wystąpienia QueryStringParameter.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
Evaluate(HttpContext, Control)	Aktualizuje i zwraca wartość obiektu QueryStringParameter.
GetDatabaseType()	Pobiera wartość DbType, która jest równoważna typowi CLR bieżącego wystąpienia Parameter. (Odziedziczone po Parameter)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
LoadViewState(Object)	Przywraca wcześniej zapisany stan widoku źródła danych. (Odziedziczone po Parameter)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
OnParameterChanged()	Wywołuje metodę OnParametersChanged(EventArgs) kolekcji ParameterCollection zawierającą obiekt Parameter. (Odziedziczone po Parameter)
SaveViewState()	Zapisuje zmiany w stanie widoku obiektu Parameter od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Parameter)
SetDirty()	Oznacza obiekt Parameter, aby jego stan był rejestrowany w stanie widoku. (Odziedziczone po Parameter)
ToString()	Konwertuje wartość tego wystąpienia na równoważną reprezentację ciągu. (Odziedziczone po Parameter)
TrackViewState()	Powoduje, że obiekt Parameter śledzić zmiany stanu widoku, dzięki czemu mogą być przechowywane w ViewState obiektu kontrolki i utrwalane w żądaniach dla tej samej strony. (Odziedziczone po Parameter)

Jawne implementacje interfejsu

ICloneable.Clone()	Zwraca duplikat bieżącego wystąpienia Parameter. (Odziedziczone po Parameter)
IStateManager.IsTrackingViewState	Pobiera wartość wskazującą, czy obiekt Parameter zapisuje zmiany w stanie widoku. (Odziedziczone po Parameter)
IStateManager.LoadViewState(Object)	Przywraca wcześniej zapisany stan widoku źródła danych. (Odziedziczone po Parameter)
IStateManager.SaveViewState()	Zapisuje zmiany w stanie widoku obiektu Parameter od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Parameter)
IStateManager.TrackViewState()	Powoduje, że obiekt Parameter śledzić zmiany stanu widoku, dzięki czemu mogą być przechowywane w ViewState obiektu kontrolki i utrwalane w żądaniach dla tej samej strony. (Odziedziczone po Parameter)

Dotyczy

Udostępnij za pośrednictwem