QueryStringParameter Osztály

Definíció

Névtér:: System.Web.UI.WebControls

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Egy HTTP-kérelem lekérdezési sztring mezőjének értékét egy paraméterobjektumhoz köti.

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

Öröklődés: Object

Parameter
QueryStringParameter

Példák

Az alábbi példa bemutatja, hogyan hozhat létre QueryStringParameter szűrőként használandó objektumot, amikor adatokat jelenít meg egy GridView vezérlőben. Hozzáadhatja az QueryStringParameter objektumot a AccessDataSource vezérlő gyűjteményéhez FilterParameters . A paraméterobjektum a lekérdezési sztring mező country értékét a sztringhez köti FilterExpression . Mivel a paraméterhez nincs DefaultValue megadva tulajdonság, ha a lekérdezési sztringgel nem ad át elnevezett country mezőt, a AccessDataSource vezérlő kivételt NullReferenceException eredményez. Ha egy elnevezett country mező átadva van, de nincs értéke, a GridView vezérlő nem jelenít meg adatokat.

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

Megjegyzések

Az QueryStringParameter osztály használatával egy HTTP-kérelem lekérdezési sztringje részeként átadott mező értékét egy paraméteres lekérdezésben vagy parancsban használt paraméterhez kötheti. A mező lekéri a QueryString gyűjteményből.

A paraméterhez adatokat kötő vezérlők kivételt jelenthetnek, ha egy QueryStringParameter objektumra hivatkoznak, de a rendszer nem ad át megfelelő lekérdezési sztringnevet/értékpárt. Hasonlóképpen nem jeleníthetnek meg adatokat, ha a lekérdezési sztring mező neve megfelelő érték nélkül van átadva. Az ilyen helyzetek elkerülése érdekében szükség szerint állítsa be a DefaultValue tulajdonságot.

Az QueryStringParameter osztály biztosítja a QueryStringField tulajdonságot, amely azonosítja annak a lekérdezési sztringértéknek a nevét, amelyhez kötést kíván kötni. Emellett az osztálytól Parameter örökölt tulajdonságokat is tartalmazza.

Important

Az QueryStringParameter osztály nem ellenőrzi az átadott értéket, hanem a nyers értéket adja meg. Az adatforrás-vezérlőben azonban ellenőrizheti egy QueryStringParameter objektum értékét. Ehhez kezelje az Selectingadatforrás-vezérlő , Updating, Insertingvagy Deleting eseményét, és ellenőrizze a paraméter értékét az eseménykezelőben. Ha a paraméter értéke nem felel meg az érvényesítési teszteknek, a társított Cancel osztály CancelEventArgstulajdonságának beállításával true megszakíthatja az adatműveletet.

Konstruktorok

Name	Description
QueryStringParameter()	Inicializálja az osztály új, meg nem nevezett példányát QueryStringParameter .
QueryStringParameter(QueryStringParameter)	Inicializálja az QueryStringParameter osztály új példányát a paraméter által megadott példány értékeinek `original` használatával.
QueryStringParameter(String, DbType, String)	Inicializálja az QueryStringParameter osztály új nevesített példányát a megadott lekérdezési sztring mező és a paraméter adattípusa használatával.
QueryStringParameter(String, String)	Inicializálja az QueryStringParameter osztály új nevesített példányát a megadott sztring használatával annak azonosításához, hogy melyik lekérdezési sztringmezőhöz kell csatlakozni.
QueryStringParameter(String, TypeCode, String)	Inicializálja az QueryStringParameter osztály új elnevezett és erősen gépelt példányát a megadott sztring használatával annak azonosításához, hogy melyik lekérdezési sztringmezőhöz kell csatlakozni.

Tulajdonságok

Name	Description
ConvertEmptyStringToNull	Lekéri vagy beállít egy értéket, amely jelzi, hogy az Parameter objektumhoz kötött értéket konvertálni `null` kell-e, ha igen Empty. (Öröklődés forrása Parameter)
DbType	Lekéri vagy beállítja a paraméter adatbázistípusát. (Öröklődés forrása Parameter)
DefaultValue	A paraméter alapértelmezett értékét adja meg, ha a metódus meghívásakor Evaluate(HttpContext, Control) a paraméter nem inicializálódik. (Öröklődés forrása Parameter)
Direction	Azt jelzi, hogy az Parameter objektum egy vezérlőelemhez köti-e az értéket, vagy a vezérlőelem használható az érték módosítására. (Öröklődés forrása Parameter)
IsTrackingViewState	Beolvas egy értéket, amely jelzi, hogy az Parameter objektum menti-e a nézetállapot módosításait. (Öröklődés forrása Parameter)
Name	Lekéri vagy beállítja a paraméter nevét. (Öröklődés forrása Parameter)
QueryStringField	Lekéri vagy beállítja annak a lekérdezési sztringmezőnek a nevét, amelyhez a paraméter kapcsolódik.
Size	Lekéri vagy beállítja a paraméter méretét. (Öröklődés forrása Parameter)
Type	Lekéri vagy beállítja a paraméter típusát. (Öröklődés forrása Parameter)
ValidateInput	Lekérdezi vagy beállítja, hogy a lekérdezési sztring paraméter értéke érvényesítve van-e.
ViewState	Lekéri az állapotinformációk szótárát, amely lehetővé teszi egy objektum nézetállapotának mentését és visszaállítását Parameter ugyanazon lap több kérésében. (Öröklődés forrása Parameter)

Metódusok

Name	Description
Clone()	Az aktuális QueryStringParameter példány duplikátumát adja vissza.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
Evaluate(HttpContext, Control)	Frissíti és visszaadja az QueryStringParameter objektum értékét.
GetDatabaseType()	Lekéri az DbType aktuális Parameter példány CLR-típusával egyenértékű értéket. (Öröklődés forrása Parameter)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
LoadViewState(Object)	Visszaállítja az adatforrásnézet korábban mentett nézetállapotát. (Öröklődés forrása Parameter)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnParameterChanged()	Meghívja OnParametersChanged(EventArgs) az ParameterCollection objektumot tartalmazó gyűjtemény metódusátParameter. (Öröklődés forrása Parameter)
SaveViewState()	Menti az Parameter objektum nézetállapotának módosításait a lap kiszolgálóra való visszatérése óta. (Öröklődés forrása Parameter)
SetDirty()	Megjelöli az Parameter objektumot, hogy az állapota megtekintési állapotban legyen rögzítve. (Öröklődés forrása Parameter)
ToString()	A példány értékét a megfelelő sztring-ábrázolásúvá alakítja. (Öröklődés forrása Parameter)
TrackViewState()	Ez azt eredményezi, hogy az Parameter objektum nyomon követi a nézetállapot változásait, hogy azok a vezérlő ViewState objektumában tárolhatók legyenek, és ugyanazon lap kérései között megmaradjanak. (Öröklődés forrása Parameter)

Explicit interfész-implementációk

Name	Description
ICloneable.Clone()	Az aktuális Parameter példány duplikátumát adja vissza. (Öröklődés forrása Parameter)
IStateManager.IsTrackingViewState	Beolvas egy értéket, amely jelzi, hogy az Parameter objektum menti-e a nézetállapot módosításait. (Öröklődés forrása Parameter)
IStateManager.LoadViewState(Object)	Visszaállítja az adatforrásnézet korábban mentett nézetállapotát. (Öröklődés forrása Parameter)
IStateManager.SaveViewState()	Menti az Parameter objektum nézetállapotának módosításait a lap kiszolgálóra való visszatérése óta. (Öröklődés forrása Parameter)
IStateManager.TrackViewState()	Ez azt eredményezi, hogy az Parameter objektum nyomon követi a nézetállapot változásait, hogy azok a vezérlő ViewState objektumában tárolhatók legyenek, és ugyanazon lap kérései között megmaradjanak. (Öröklődés forrása Parameter)

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?