CookieParameter Klasse

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 parameterisierten Befehl verwendet werden, um Daten auszuwählen, zu filtern oder zu aktualisieren.

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 Ein SqlDataSource Steuerelement und CookieParameter Objekt verwendet werden, 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 zu binden, das als Teil einer HTTP-Anforderung an einen Parameter übergeben wird, der von ASP.NET Datenquellensteuerelementen verwendet wird.

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

Von Bedeutung

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

Konstruktoren

Name	Beschreibung
CookieParameter()	Initialisiert eine neue unbenannte Instanz der CookieParameter Klasse.
CookieParameter(CookieParameter)	Initialisiert eine neue Instanz der CookieParameter Klasse mit den Werten der vom Parameter angegebenen `original` Instanz.
CookieParameter(String, DbType, String)	Initialisiert eine neue Instanz der CookieParameter Klasse mit dem angegebenen Namen und Datenbanktyp, die an das angegebene HTTP-Cookie gebunden ist.
CookieParameter(String, String)	Initialisiert eine neue benannte Instanz der Klasse mithilfe der CookieParameter angegebenen Zeichenfolge, um zu identifizieren, an welches HTTP-Cookie gebunden werden soll.
CookieParameter(String, TypeCode, String)	Initialisiert eine neue benannte und stark typierte Instanz der Klasse mithilfe der CookieParameter angegebenen Zeichenfolge, um zu identifizieren, an welches HTTP-Cookie gebunden werden soll.

Eigenschaften

Name	Beschreibung
ConvertEmptyStringToNull	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Wert, an den das Parameter Objekt gebunden ist, konvertiert `null` werden soll, wenn es ist Empty. (Geerbt von Parameter)
CookieName	Ruft den Namen des HTTP-Cookies ab, an das der Parameter gebunden ist, oder legt diesen fest.
DbType	Dient zum Abrufen oder Festlegen des Datenbanktyps des Parameters. (Geerbt von Parameter)
DefaultValue	Gibt einen Standardwert für den Parameter an, sollte der Wert, an den der Parameter gebunden ist, nicht initialisiert werden, wenn die Evaluate(HttpContext, Control) Methode aufgerufen wird. (Geerbt von Parameter)
Direction	Gibt an, ob das Parameter Objekt verwendet wird, um einen Wert an ein Steuerelement zu binden, oder das Steuerelement kann verwendet werden, um den Wert zu ändern. (Geerbt von Parameter)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Parameter Objekt Änderungen am Ansichtszustand speichert. (Geerbt von Parameter)
Name	Dient zum Abrufen oder Festlegen des Namens des Parameters. (Geerbt von Parameter)
Size	Dient zum Abrufen oder Festlegen der Größe des Parameters. (Geerbt von Parameter)
Type	Dient zum Abrufen oder Festlegen des Typs des Parameters. (Geerbt von Parameter)
ValidateInput	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Wert des Parameters überprüft wird.
ViewState	Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Parameter Objekts über mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von Parameter)

Methoden

Name	Beschreibung
Clone()	Gibt ein Duplikat der aktuellen CookieParameter Instanz zurück.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
Evaluate(HttpContext, Control)	Aktualisiert und gibt den Wert des CookieParameter Objekts zurück.
GetDatabaseType()	Ruft den DbType Wert ab, der dem CLR-Typ der aktuellen Parameter Instanz entspricht. (Geerbt von Parameter)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von Parameter)
MemberwiseClone()	Erstellt eine flache Kopie der 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 wieder auf dem Server gepostet wurde. (Geerbt von Parameter)
SetDirty()	Markiert das Parameter Objekt so, dass 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 am Ansichtszustand nachverfolgt, sodass sie im Objekt des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von Parameter)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
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 am Ansichtszustand speichert. (Geerbt von Parameter)
IStateManager.LoadViewState(Object)	Stellt den zuvor 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 wieder auf dem Server gepostet wurde. (Geerbt von Parameter)
IStateManager.TrackViewState()	Bewirkt, dass das Parameter Objekt Änderungen am Ansichtszustand nachverfolgt, sodass sie im Objekt des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von Parameter)

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?