CookieParameter 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 ügyféloldali HTTP-cookie értékét egy paraméterobjektumhoz köti. A paraméter paraméteres lekérdezésben vagy parancsban használható adatok kiválasztására, szűrésére vagy frissítésére.

public ref class CookieParameter : System::Web::UI::WebControls::Parameter

public class CookieParameter : System.Web.UI.WebControls.Parameter

type CookieParameter = class
    inherit Parameter

Public Class CookieParameter
Inherits Parameter

Öröklődés: Object

Parameter
CookieParameter

Példák

Az alábbi kódpéldából megtudhatja, hogyan jeleníthet meg adatokat a Northwind Traders adatbázisából egy vezérlőben SqlDataSource http-cookie-hoz CookieParameter kötött vezérlővel és GridView objektummal.

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

void Page_Load(Object sender, EventArgs e){
  // These cookies might be added by a login form.
  // They are added here for simplicity.
  if (!IsPostBack) {
      Response.Cookies.Add(new HttpCookie("lname",    "davolio"));
      Response.Cookies.Add(new HttpCookie("loginname","ndavolio"));
      Response.Cookies.Add(new HttpCookie("lastvisit", DateTime.Now.ToString()));
  }
}


</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand = "SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate 
                           FROM Orders WHERE EmployeeID = 
                           (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
          <SelectParameters>
            <asp:CookieParameter Name="lastname" CookieName="lname" />
          </SelectParameters>
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AllowSorting="True"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </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">

<script runat="server">

Sub Page_Load(sender As Object, e As EventArgs)
  ' These cookies might be added by a login form.
  ' They are added here for simplicity.
  If (Not IsPostBack) Then
      Dim cookie As HttpCookie

      cookie = New HttpCookie("lname","davolio")
      Response.Cookies.Add(cookie)

      cookie = New HttpCookie("loginname","ndavolio")
      Response.Cookies.Add(cookie)

      cookie = New HttpCookie("lastvisit", DateTime.Now.ToString())
      Response.Cookies.Add(cookie)
  End If
End Sub ' Page_Load
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand = "SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate 
                           FROM Orders WHERE EmployeeID = 
                           (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
          <SelectParameters>                 
            <asp:CookieParameter Name="lastname" CookieName="lname" />
          </SelectParameters>
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AllowSorting="True"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

Megjegyzések

A CookieParameter osztály használatával a HTTP-kérés részeként átadott ügyféloldali HTTP-cookie értékét egy ASP.NET adatforrás-vezérlők által használt paraméterhez kötheti.

Az CookieParameter osztály biztosítja a CookieName tulajdonságot, amely az osztálytól HttpCookie örökölt objektumokon kívül azonosítja a Parameter kötés tárgyát képező objektum nevét. Az CookieParameter osztály minden alkalommal megpróbál csatlakozni az elnevezett cookie-hoz, amikor a Evaluate metódust meghívják.

Important

A paraméterhez adatokat kötő vezérlők kivételt jelenthetnek, ha egy CookieParameter objektum meg van adva, de a HTTP-kérés nem ad át megfelelő cookie-t. Hasonlóképpen előfordulhat, hogy nem jelenít meg adatokat, ha a cookie-t átadják null. Állítsa be a tulajdonságot DefaultValue , hogy szükség esetén elkerülje ezeket a helyzeteket.

Konstruktorok

Név	Description
CookieParameter()	Inicializálja az osztály új, meg nem nevezett példányát CookieParameter .
CookieParameter(CookieParameter)	Inicializálja az CookieParameter osztály új példányát a paraméter által `original` megadott példány értékeivel.
CookieParameter(String, DbType, String)	Inicializálja annak az osztálynak az CookieParameter új példányát, amely a megadott névvel és adatbázistípussal rendelkezik, és amely a megadott HTTP-cookie-hoz van kötve.
CookieParameter(String, String)	Inicializálja az CookieParameter osztály új nevesített példányát a megadott sztring használatával annak azonosításához, hogy melyik HTTP-cookie-hoz kell kapcsolódnia.
CookieParameter(String, TypeCode, String)	Inicializálja az CookieParameter osztály új nevesített és erősen gépelt példányát a megadott sztring használatával annak azonosításához, hogy melyik HTTP-cookie-hoz kell kapcsolódnia.

Tulajdonságok

Név	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)
CookieName	Lekéri vagy beállítja annak a HTTP-cookie-nak a nevét, amelyhez a paraméter kapcsolódik.
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)
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éri vagy beállít egy értéket, amely meghatározza, hogy a 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

Név	Description
Clone()	Az aktuális CookieParameter 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 CookieParameter 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

Név	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?