CookieParameter Klasse

Definition

Bindet den Wert eines clientseitigen HTTP-Cookies an ein Parameterobjekt.Binds the value of a client-side HTTP cookie to a parameter object. Der Parameter kann in einer parametrisierten Abfrage oder einem parametrisierten Befehl zum Auswählen, Filtern oder Aktualisieren von Daten verwendet werden.The parameter can be used in a parameterized query or command to select, filter, or update 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
Vererbung
CookieParameter

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein SqlDataSource -Steuerelement und ein-Objekt, die CookieParameter an ein HTTP-Cookie gebunden sind, verwendet werden, um Daten aus der Northwind Traders-Datenbank in einem GridViewThe following code example demonstrates how to use a SqlDataSource control and CookieParameter object bound to an HTTP cookie to display data from the Northwind Traders database in a GridView control.

<%@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 Client seitigen http-Cookies, das als Teil einer HTTP-Anforderung übergeben wird, an einen von ASP.NET Data Source-Steuerelementen verwendeten Parameter zu binden.You can use the CookieParameter class to bind the value of a client-side HTTP cookie passed as part of an HTTP request to a parameter used by ASP.NET data source controls.

Die- CookieParameter Klasse stellt die- CookieName Eigenschaft bereit, die den Namen des Objekts identifiziert, an das die Bindung erfolgen soll HttpCookie , zusätzlich zu den von der-Klasse geerbten Objekten Parameter .The CookieParameter class provides the CookieName property, which identifies the name of the HttpCookie object to bind to, in addition to those inherited from the Parameter class. Die- CookieParameter Klasse versucht jedes Mal, wenn die- Evaluate Methode aufgerufen wird, an das benannte Cookie zu binden.The CookieParameter class attempts to bind to the named cookie every time the Evaluate method is called.

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 mit der HTTP-Anforderung übergeben wird.Controls that bind data to the parameter might throw an exception if a CookieParameter object is specified, but no corresponding cookie is passed with the HTTP request. Ebenso werden möglicherweise keine Daten angezeigt, wenn das Cookie mit übermittelt wird null .Similarly, they might display no data if the cookie is passed with null. Legen Sie die- DefaultValue Eigenschaft fest, um diese Situationen bei Bedarf zu vermeiden.Set the DefaultValue property to avoid these situations where appropriate.

Konstruktoren

CookieParameter()

Initialisiert eine neue unbenannte Instanz der CookieParameter-Klasse.Initializes a new unnamed instance of the CookieParameter class.

CookieParameter(CookieParameter)

Initialisiert eine neue Instanz der CookieParameter-Klasse mit den Werten der Instanz, die vom original-Parameter angegeben wird.Initializes a new instance of the CookieParameter class with the values of the instance specified by the original parameter.

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.Initializes a new instance of the CookieParameter class that has the specified name and database type and that is bound to the specified 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.Initializes a new named instance of the CookieParameter class, using the specified string to identify which HTTP cookie to bind to.

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.Initializes a new named and strongly typed instance of the CookieParameter class, using the specified string to identify which HTTP cookie to bind to.

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.Gets or sets a value indicating whether the value that the Parameter object is bound to should be converted to null if it is Empty.

(Geerbt von Parameter)
CookieName

Ruft den Namen des HTTP-Cookies ab, an das der Parameter gebunden wird, oder legt diesen fest.Gets or sets the name of the HTTP cookie that the parameter binds to.

DbType

Ruft den Datenbanktyp des Parameters ab oder legt diesen fest.Gets or sets the database type of the parameter.

(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.Specifies a default value for the parameter, should the value that the parameter is bound to be uninitialized when the Evaluate(HttpContext, Control) method is called.

(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.Indicates whether the Parameter object is used to bind a value to a control, or the control can be used to change the value.

(Geerbt von Parameter)
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Geerbt von Parameter)
Name

Ruft den Namen des Parameters ab oder legt ihn fest.Gets or sets the name of the parameter.

(Geerbt von Parameter)
Size

Ruft die Größe des Parameters ab oder legt sie fest.Gets or sets the size of the parameter.

(Geerbt von Parameter)
Type

Ruft den Typ des Parameters ab oder legt ihn fest.Gets or sets the type of the parameter.

(Geerbt von Parameter)
ValidateInput

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Parameterwert überprüft wird.Gets or sets a value that specifies whether the parameter's value is validated.

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.Gets a dictionary of state information that allows you to save and restore the view state of a Parameter object across multiple requests for the same page.

(Geerbt von Parameter)

Methoden

Clone()

Gibt ein Duplikat der aktuellen CookieParameter-Instanz zurück.Returns a duplicate of the current CookieParameter instance.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
Evaluate(HttpContext, Control)

Aktualisiert den Wert des CookieParameter-Objekts und gibt ihn zurück.Updates and returns the value of the CookieParameter object.

GetDatabaseType()

Ruft den DbType-Wert ab, der dem CLR-Typ der aktuellen Parameter-Instanz entspricht.Gets the DbType value that is equivalent to the CLR type of the current Parameter instance.

(Geerbt von Parameter)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
LoadViewState(Object)

Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.Restores the data source view's previously saved view state.

(Geerbt von Parameter)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnParameterChanged()

Ruft die OnParametersChanged(EventArgs)-Methode der ParameterCollection-Auflistung auf, die das Parameter-Objekt enthält.Calls the OnParametersChanged(EventArgs) method of the ParameterCollection collection that contains the Parameter object.

(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.Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(Geerbt von Parameter)
SetDirty()

Markiert das Parameter-Objekt, damit sein Zustand im Ansichtszustand aufgezeichnet wird.Marks the Parameter object so its state will be recorded in view state.

(Geerbt von Parameter)
ToString()

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.Converts the value of this instance to its equivalent string representation.

(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.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page.

(Geerbt von Parameter)

Explizite Schnittstellenimplementierungen

ICloneable.Clone()

Gibt ein Duplikat der aktuellen Parameter-Instanz zurück.Returns a duplicate of the current Parameter instance.

(Geerbt von Parameter)
IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Parameter-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Geerbt von Parameter)
IStateManager.LoadViewState(Object)

Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.Restores the data source view's previously saved view state.

(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.Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(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.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page.

(Geerbt von Parameter)

Gilt für:

Siehe auch