CookieParameter Třída

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 souboru cookie HTTP na straně klienta s objektem parametru. Parametr lze použít v parametrizovaném dotazu nebo příkazu k výběru, filtrování nebo aktualizaci dat.

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

Dědičnost: Object

Parameter
CookieParameter

Příklady

Následující příklad kódu ukazuje, jak pomocí SqlDataSource ovládacího prvku a CookieParameter objektu vázaného na soubor cookie HTTP zobrazit data z databáze Northwind Traders v ovládacím GridView prvku.

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

Poznámky

Třídu můžete použít CookieParameter k vytvoření vazby hodnoty souboru cookie HTTP na straně klienta předávaného jako součást požadavku HTTP na parametr používaný ASP.NET ovládacími prvky zdroje dat.

CookieParameter Třída poskytuje CookieName vlastnost, která identifikuje název objektuHttpCookie, ke kterému má být vázán, kromě zděděných z Parameter třídy. Třída CookieParameter se pokusí vytvořit vazbu na pojmenovaný soubor cookie při Evaluate každém volání metody.

Důležité

Ovládací prvky, které sváže data s parametrem, mohou vyvolat výjimku, pokud CookieParameter je zadán objekt, ale žádný odpovídající soubor cookie se nepředá s požadavkem HTTP. Podobně mohou zobrazit žádná data, pokud je soubor cookie předán null. DefaultValue Nastavte vlastnost tak, aby se těmto situacím v případě potřeby vyhnula.

Konstruktory

Name	Description
CookieParameter()	Inicializuje novou nepojmenovanou instanci CookieParameter třídy.
CookieParameter(CookieParameter)	Inicializuje novou instanci CookieParameter třídy s hodnotami instance určené parametrem `original` .
CookieParameter(String, DbType, String)	Inicializuje novou instanci CookieParameter třídy, která má zadaný název a typ databáze a který je vázán na zadaný soubor cookie HTTP.
CookieParameter(String, String)	Inicializuje novou pojmenovanou instanci CookieParameter třídy pomocí zadaného řetězce k identifikaci souboru cookie HTTP, ke kterému se má vytvořit vazba.
CookieParameter(String, TypeCode, String)	Inicializuje novou pojmenovanou a silně typovou instanci CookieParameter třídy pomocí zadaného řetězce k identifikaci souboru cookie HTTP, ke kterému se má vytvořit vazba.

Vlastnosti

Name	Description
ConvertEmptyStringToNull	Získá nebo nastaví hodnotu určující, zda hodnota, na kterou Parameter je objekt vázán, by měla být převedena na `null` , pokud je Empty. (Zděděno od Parameter)
CookieName	Získá nebo nastaví název souboru cookie HTTP, ke kterému parametr vytvoří vazbu.
DbType	Získá nebo nastaví typ databáze parametru. (Zděděno od Parameter)
DefaultValue	Určuje výchozí hodnotu parametru, pokud má být parametr vázán na neinicializaci při Evaluate(HttpContext, Control) zavolání metody. (Zděděno od Parameter)
Direction	Určuje, zda Parameter se objekt používá k vytvoření vazby hodnoty k ovládacímu prvku, nebo lze 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)
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í hodnotu, která určuje, zda je hodnota parametru ověřena.
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení objektu Parameter napříč více požadavky na stejnou stránku. (Zděděno od Parameter)

Metody

Name	Description
Clone()	Vrátí duplikát aktuální CookieParameter instance.
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 CookieParameter .
GetDatabaseType()	DbType Získá 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()	Type Získá aktuální instanci. (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()	OnParametersChanged(EventArgs) Volá metodu ParameterCollection kolekce, která obsahuje Parameter objekt. (Zděděno od Parameter)
SaveViewState()	Uloží změny do stavu zobrazení objektu Parameter od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Parameter)
SetDirty()	Parameter Označí objekt 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 Parameter objekt 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í

Name	Description
ICloneable.Clone()	Vrátí duplikát aktuální Parameter instance. (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í objektu Parameter od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Parameter)
IStateManager.TrackViewState()	Způsobí, že Parameter objekt 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

Viz také

Váš názor

Byla tato stránka užitečná?