QueryStringParameter Třída

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vytvoří vazbu hodnoty pole dotazu požadavku HTTP na objekt 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

Dědičnost: Object

Parameter
QueryStringParameter

Příklady

Následující příklad ukazuje, jak vytvořit QueryStringParameter objekt, který se použije jako filtr při zobrazení dat v ovládacím prvku GridView. Objekt QueryStringParameter přidáte do kolekce FilterParameters ovládacího prvku AccessDataSource. Objekt parametru sváže hodnotu pole řetězce dotazu s názvem country na jeho FilterExpression řetězec. Vzhledem k tomu, že pro parametr není zadána žádná DefaultValue vlastnost, pokud není předáno žádné pole s názvem country s řetězcem dotazu, vyvolá ovládací prvek AccessDataSource výjimku NullReferenceException. Pokud je pole s názvem country předáno, ale nemá žádnou hodnotu, ovládací prvek GridView nezobrazí žádná 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>

Poznámky

Třídu QueryStringParameter můžete použít k vytvoření vazby hodnoty pole předávaného jako součást řetězce dotazu požadavku HTTP na parametr použitý v parametrizovaném dotazu nebo příkazu. Pole se načte z kolekce QueryString.

Ovládací prvky, které sváže data s parametrem, mohou vyvolat výjimku, pokud je odkazován na objekt QueryStringParameter, ale není předán žádný odpovídající pár název/hodnota řetězce dotazu. Podobně můžou v případě předání názvu pole řetězce dotazu bez odpovídající hodnoty zobrazit žádná data. Pokud se chcete těmto situacím vyhnout, nastavte DefaultValue vlastnost tam, kde je to vhodné.

Třída QueryStringParameter poskytuje vlastnost QueryStringField, která identifikuje název řetězcové hodnoty dotazu, ke které má být vázána. Poskytuje také vlastnosti, které jsou zděděné z Parameter třídy.

Důležitý

Třída QueryStringParameter neověřuje předanou hodnotu; poskytuje nezpracovanou hodnotu. Můžete ale ověřit hodnotu objektu QueryStringParameter v ovládacím prvku zdroje dat. Provedete to tak, že zpracujete Selecting, Updating, Insertingnebo Deleting událost ovládacího prvku zdroje dat a zkontrolujete hodnotu parametru v obslužné rutině události. Pokud hodnota parametru neprojde ověřovacími testy, můžete operaci dat zrušit nastavením vlastnosti Cancel přidružené třídy CancelEventArgs na true.

Konstruktory

QueryStringParameter()	Inicializuje novou nepojmenovanou instanci třídy QueryStringParameter.
QueryStringParameter(QueryStringParameter)	Inicializuje novou instanci QueryStringParameter třídy pomocí hodnot instance, která je určena parametrem `original`.
QueryStringParameter(String, DbType, String)	Inicializuje novou pojmenovanou instanci třídy QueryStringParameter pomocí zadaného pole řetězce dotazu a datového typu parametru.
QueryStringParameter(String, String)	Inicializuje novou pojmenovanou instanci třídy QueryStringParameter pomocí zadaného řetězce k identifikaci pole řetězce dotazu, ke kterému se má vytvořit vazba.
QueryStringParameter(String, TypeCode, String)	Inicializuje novou pojmenovanou a silně typovou instanci třídy QueryStringParameter pomocí zadaného řetězce k identifikaci pole řetězce dotazu, které se má svázat.

Vlastnosti

ConvertEmptyStringToNull	Získá nebo nastaví hodnotu určující, zda hodnota, na kterou je objekt Parameter vázán, by měl být převeden na `null` pokud je Empty. (Zděděno od Parameter)
DbType	Získá nebo nastaví typ databáze parametru. (Zděděno od Parameter)
DefaultValue	Určuje výchozí hodnotu parametru, pokud je hodnota, která je vázána k neinicializaci při Evaluate(HttpContext, Control) metoda je volána. (Zděděno od Parameter)
Direction	Určuje, zda se Parameter objekt používá k vytvoření vazby hodnoty k ovládacímu prvku, nebo lze ovládací prvek použít ke změně hodnoty. (Zděděno od Parameter)
IsTrackingViewState	Získá hodnotu určující, zda Parameter objekt ukládá změny do jeho stavu zobrazení. (Zděděno od Parameter)
Name	Získá nebo nastaví název parametru. (Zděděno od Parameter)
QueryStringField	Získá nebo nastaví název pole řetězce dotazu, ke kterému parametr vytvoří vazbu.
Size	Získá nebo nastaví velikost parametru. (Zděděno od Parameter)
Type	Získá nebo nastaví typ parametru. (Zděděno od Parameter)
ValidateInput	Získá nebo nastaví, zda hodnota parametru řetězce dotazu je ověřena, nebo ne.
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení Parameter objektu napříč více požadavky na stejnou stránku. (Zděděno od Parameter)

Metody

Clone()	Vrátí duplikát aktuální instance QueryStringParameter.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
Evaluate(HttpContext, Control)	Aktualizuje a vrátí hodnotu objektu QueryStringParameter.
GetDatabaseType()	Získá DbType hodnotu, která je ekvivalentní typu CLR aktuální Parameter instance. (Zděděno od Parameter)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
LoadViewState(Object)	Obnoví dříve uložený stav zobrazení zdroje dat. (Zděděno od Parameter)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnParameterChanged()	Volá metodu OnParametersChanged(EventArgs) kolekce ParameterCollection, která obsahuje objekt Parameter. (Zděděno od Parameter)
SaveViewState()	Uloží změny do stavu zobrazení Parameter objektu od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Parameter)
SetDirty()	Označí objekt Parameter tak, aby byl jeho stav zaznamenán ve stavu zobrazení. (Zděděno od Parameter)
ToString()	Převede hodnotu této instance na ekvivalentní řetězcové vyjádření. (Zděděno od Parameter)
TrackViewState()	Způsobí, že objekt Parameter bude sledovat změny jeho stavu zobrazení, aby je bylo možné uložit do objektu ViewState ovládacího prvku a zachovat napříč požadavky na stejnou stránku. (Zděděno od Parameter)

Explicitní implementace rozhraní

ICloneable.Clone()	Vrátí duplikát aktuální instance Parameter. (Zděděno od Parameter)
IStateManager.IsTrackingViewState	Získá hodnotu určující, zda Parameter objekt ukládá změny do jeho stavu zobrazení. (Zděděno od Parameter)
IStateManager.LoadViewState(Object)	Obnoví dříve uložený stav zobrazení zdroje dat. (Zděděno od Parameter)
IStateManager.SaveViewState()	Uloží změny do stavu zobrazení Parameter objektu od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Parameter)
IStateManager.TrackViewState()	Způsobí, že objekt Parameter bude sledovat změny jeho stavu zobrazení, aby je bylo možné uložit do objektu ViewState ovládacího prvku a zachovat napříč požadavky na stejnou stránku. (Zděděno od Parameter)

Platí pro

Sdílet prostřednictvím