CookieParameter Klass

Definition

Namnområde:: System.Web.UI.WebControls

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Binder värdet för en HTTP-cookie på klientsidan till ett parameterobjekt. Parametern kan användas i en parameteriserad fråga eller ett kommando för att välja, filtrera eller uppdatera data.

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

Arv: Object

Parameter
CookieParameter

Exempel

Följande kodexempel visar hur du använder en kontroll och SqlDataSource ett CookieParameter objekt som är bundet till en HTTP-cookie för att visa data från Northwind Traders-databasen i en GridView kontroll.

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

Kommentarer

Du kan använda klassen CookieParameter för att binda värdet för en HTTP-cookie på klientsidan som skickas som en del av en HTTP-begäran till en parameter som används av ASP.NET datakällkontroller.

Klassen CookieParameter tillhandahåller CookieName egenskapen, som identifierar namnet på objektet som HttpCookie ska bindas till, utöver de som ärvts från Parameter klassen. Klassen CookieParameter försöker binda till den namngivna cookien varje gång Evaluate metoden anropas.

Important

Kontroller som binder data till parametern kan utlösa ett undantag om ett CookieParameter objekt har angetts, men ingen motsvarande cookie skickas med HTTP-begäran. På samma sätt kan de inte visa några data om cookien skickas med null. Ställ in egenskapen DefaultValue för att undvika dessa situationer när det är lämpligt.

Konstruktorer

Name	Description
CookieParameter()	Initierar en ny namnlös instans av CookieParameter klassen.
CookieParameter(CookieParameter)	Initierar en ny instans av CookieParameter klassen med värdena för den instans som anges av parametern `original` .
CookieParameter(String, DbType, String)	Initierar en ny instans av CookieParameter klassen som har det angivna namnet och databastypen och som är bunden till den angivna HTTP-cookien.
CookieParameter(String, String)	Initierar en ny namngiven CookieParameter instans av klassen med hjälp av den angivna strängen för att identifiera vilken HTTP-cookie som ska bindas till.
CookieParameter(String, TypeCode, String)	Initierar en ny namngiven och starkt typinstans av klassen med hjälp av den angivna strängen CookieParameter för att identifiera vilken HTTP-cookie som ska bindas till.

Egenskaper

Name	Description
ConvertEmptyStringToNull	Hämtar eller anger ett värde som anger om värdet som objektet är bundet Parameter till ska konverteras till `null` om det är Empty. (Ärvd från Parameter)
CookieName	Hämtar eller anger namnet på DEN HTTP-cookie som parametern binder till.
DbType	Hämtar eller anger parameterns databastyp. (Ärvd från Parameter)
DefaultValue	Anger ett standardvärde för parametern om värdet som parametern är bunden till är onitialiserat när Evaluate(HttpContext, Control) metoden anropas. (Ärvd från Parameter)
Direction	Anger om objektet Parameter används för att binda ett värde till en kontroll eller om kontrollen kan användas för att ändra värdet. (Ärvd från Parameter)
IsTrackingViewState	Hämtar ett värde som anger om Parameter objektet sparar ändringar i visningstillståndet. (Ärvd från Parameter)
Name	Hämtar eller anger namnet på parametern. (Ärvd från Parameter)
Size	Hämtar eller anger parameterns storlek. (Ärvd från Parameter)
Type	Hämtar eller anger parametertypen. (Ärvd från Parameter)
ValidateInput	Hämtar eller anger ett värde som anger om parameterns värde verifieras.
ViewState	Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för ett Parameter objekt över flera begäranden för samma sida. (Ärvd från Parameter)

Metoder

Name	Description
Clone()	Returnerar en dubblett av den aktuella CookieParameter instansen.
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
Evaluate(HttpContext, Control)	Uppdaterar och returnerar objektets CookieParameter värde.
GetDatabaseType()	Hämtar värdet DbType som motsvarar CLR-typen för den aktuella Parameter instansen. (Ärvd från Parameter)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
LoadViewState(Object)	Återställer datakällans tidigare sparade vytillstånd. (Ärvd från Parameter)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
OnParameterChanged()	Anropar metoden för OnParametersChanged(EventArgs) samlingen ParameterCollection som innehåller Parameter objektet. (Ärvd från Parameter)
SaveViewState()	Sparar ändringarna i Parameter objektets visningstillstånd sedan den tid då sidan publicerades tillbaka till servern. (Ärvd från Parameter)
SetDirty()	Parameter Markerar objektet så att dess tillstånd registreras i visningstillstånd. (Ärvd från Parameter)
ToString()	Konverterar värdet för den här instansen till motsvarande strängrepresentation. (Ärvd från Parameter)
TrackViewState()	Parameter Gör att objektet spårar ändringar i dess visningstillstånd så att de kan lagras i kontrollens ViewState objekt och sparas mellan begäranden för samma sida. (Ärvd från Parameter)

Explicita gränssnittsimplementeringar

Name	Description
ICloneable.Clone()	Returnerar en dubblett av den aktuella Parameter instansen. (Ärvd från Parameter)
IStateManager.IsTrackingViewState	Hämtar ett värde som anger om Parameter objektet sparar ändringar i visningstillståndet. (Ärvd från Parameter)
IStateManager.LoadViewState(Object)	Återställer datakällans tidigare sparade vytillstånd. (Ärvd från Parameter)
IStateManager.SaveViewState()	Sparar ändringarna i Parameter objektets visningstillstånd sedan den tid då sidan publicerades tillbaka till servern. (Ärvd från Parameter)
IStateManager.TrackViewState()	Parameter Gör att objektet spårar ändringar i dess visningstillstånd så att de kan lagras i kontrollens ViewState objekt och sparas mellan begäranden för samma sida. (Ärvd från Parameter)

Gäller för

Se även

Feedback

Var den här sidan till hjälp?