CookieParameter Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bindet den Wert eines clientseitigen HTTP-Cookies an ein Parameterobjekt. Der Parameter kann in einer parametrisierten Abfrage oder einem parametrisierten Befehl zum Auswählen, Filtern oder Aktualisieren von Daten verwendet werden.

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

Vererbung: Object

Parameter
CookieParameter

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein Steuerelement und CookieParameter ein SqlDataSource Objekt verwenden, das an ein HTTP-Cookie gebunden ist, um Daten aus der Northwind Traders-Datenbank in einem GridView Steuerelement anzuzeigen.

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

Hinweise

Sie können die CookieParameter -Klasse verwenden, um den Wert eines clientseitigen HTTP-Cookies, das als Teil einer HTTP-Anforderung übergeben wird, an einen Parameter zu binden, der von ASP.NET Datenquellensteuerelementen verwendet wird.

Die CookieParameter -Klasse stellt die CookieName -Eigenschaft bereit, die den Namen des Objekts angibt, an das HttpCookie gebunden werden soll, zusätzlich zu den von der Parameter -Klasse geerbten Objekten. Die CookieParameter -Klasse versucht, jedes Mal, wenn die -Methode aufgerufen wird, eine Bindung an das Evaluate benannte Cookie zu binden.

Wichtig

Steuerelemente, die Daten an den Parameter binden, lösen möglicherweise eine Ausnahme aus, wenn ein CookieParameter Objekt angegeben wird, aber kein entsprechendes Cookie wird mit der HTTP-Anforderung übergeben. Ebenso werden möglicherweise keine Daten angezeigt, wenn das Cookie mit nullübergeben wird. Legen Sie die DefaultValue -Eigenschaft fest, um diese Situationen ggf. zu vermeiden.

Konstruktoren

CookieParameter()	Initialisiert eine neue unbenannte Instanz der CookieParameter-Klasse.
CookieParameter(CookieParameter)	Initialisiert eine neue Instanz der CookieParameter-Klasse mit den Werten der Instanz, die vom `original`-Parameter angegeben wird.
CookieParameter(String, DbType, String)	Initialisiert eine neue Instanz der CookieParameter-Klasse mit dem angegebenen Namen und Datenbanktyp sowie einer Bindung an das angegebene HTTP-Cookie.
CookieParameter(String, String)	Initialisiert eine neue benannte Instanz der CookieParameter-Klasse, wobei die angegebene Zeichenfolge verwendet wird, um das HTTP-Cookie zu identifizieren, an das die Bindung erfolgen soll.
CookieParameter(String, TypeCode, String)	Initialisiert eine neue benannte und stark typisierte Instanz der CookieParameter-Klasse, wobei die angegebene Zeichenfolge verwendet wird, um das HTTP-Cookie zu identifizieren, an das die Bindung erfolgen soll.

Eigenschaften

ConvertEmptyStringToNull	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Wert, an den das Parameter-Objekt gebunden ist, nach `null` konvertiert werden soll, wenn er Empty ist. (Geerbt von Parameter)
CookieName	Ruft den Namen des HTTP-Cookies ab, an das der Parameter gebunden wird, oder legt diesen fest.
DbType	Ruft den Datenbanktyp des Parameters ab oder legt diesen fest. (Geerbt von Parameter)
DefaultValue	Gibt einen Standardwert für den Parameter an, wenn der Wert, an den der Parameter gebunden ist, beim Aufrufen der Evaluate(HttpContext, Control)-Methode nicht initialisiert ist. (Geerbt von Parameter)
Direction	Gibt an, ob das Parameter-Objekt zum Binden eines Werts an ein Steuerelement oder das Steuerelement zum Ändern des Werts verwendet werden kann. (Geerbt von Parameter)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von Parameter)
Name	Ruft den Namen des Parameters ab oder legt ihn fest. (Geerbt von Parameter)
Size	Ruft die Größe des Parameters ab oder legt sie fest. (Geerbt von Parameter)
Type	Ruft den Typ des Parameters ab oder legt ihn fest. (Geerbt von Parameter)
ValidateInput	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Parameterwert überprüft wird.
ViewState	Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Parameter-Objekts über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von Parameter)

Methoden

Clone()	Gibt ein Duplikat der aktuellen CookieParameter-Instanz zurück.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Evaluate(HttpContext, Control)	Aktualisiert den Wert des CookieParameter-Objekts und gibt ihn zurück.
GetDatabaseType()	Ruft den DbType-Wert ab, der dem CLR-Typ der aktuellen Parameter-Instanz entspricht. (Geerbt von Parameter)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
LoadViewState(Object)	Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von Parameter)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnParameterChanged()	Ruft die OnParametersChanged(EventArgs)-Methode der ParameterCollection-Auflistung auf, die das Parameter-Objekt enthält. (Geerbt von Parameter)
SaveViewState()	Speichert die Änderungen am Ansichtszustand des Parameter-Objekts seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde. (Geerbt von Parameter)
SetDirty()	Markiert das Parameter-Objekt, damit sein Zustand im Ansichtszustand aufgezeichnet wird. (Geerbt von Parameter)
ToString()	Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung. (Geerbt von Parameter)
TrackViewState()	Bewirkt, dass das Parameter-Objekt Änderungen an ihrem Ansichtszustand nachverfolgt, damit sie im ViewState-Objekt des Steuerelements gespeichert und über Anforderungen der gleichen Seite hinweg beibehalten werden. (Geerbt von Parameter)

Explizite Schnittstellenimplementierungen

ICloneable.Clone()	Gibt ein Duplikat der aktuellen Parameter-Instanz zurück. (Geerbt von Parameter)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von Parameter)
IStateManager.LoadViewState(Object)	Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von Parameter)
IStateManager.SaveViewState()	Speichert die Änderungen am Ansichtszustand des Parameter-Objekts seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde. (Geerbt von Parameter)
IStateManager.TrackViewState()	Bewirkt, dass das Parameter-Objekt Änderungen an ihrem Ansichtszustand nachverfolgt, damit sie im ViewState-Objekt des Steuerelements gespeichert und über Anforderungen der gleichen Seite hinweg beibehalten werden. (Geerbt von Parameter)

Gilt für:

Freigeben über