CookieParameter CookieParameter CookieParameter CookieParameter Class

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
CookieParameterCookieParameterCookieParameterCookieParameter

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein SqlDataSource -Steuer CookieParameter Element und ein-Objekt, die an ein HTTP-Cookie gebunden sind, verwendet werden GridView , um Daten aus der Northwind Traders-Datenbank in einemThe 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 CookieName die-Eigenschaft bereit, die den Namen HttpCookie des Objekts identifiziert, an das die Bindung erfolgen soll, zusätzlich Parameter zu den von der-Klasse geerbten Objekten.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öglich CookieParameter erweise eine Ausnahme aus, wenn ein-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 über nullmittelt wird.Similarly, they might display no data if the cookie is passed with null. Legen Sie DefaultValue die-Eigenschaft fest, um diese Situationen bei Bedarf zu vermeiden.Set the DefaultValue property to avoid these situations where appropriate.

Konstruktoren

CookieParameter() CookieParameter() CookieParameter() CookieParameter()

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

CookieParameter(CookieParameter) CookieParameter(CookieParameter) CookieParameter(CookieParameter) 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) CookieParameter(String, DbType, String) CookieParameter(String, DbType, String) 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) CookieParameter(String, String) CookieParameter(String, String) 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) CookieParameter(String, TypeCode, String) CookieParameter(String, TypeCode, String) 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 ConvertEmptyStringToNull ConvertEmptyStringToNull 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.

(Inherited from Parameter)
CookieName CookieName CookieName 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 DbType DbType DbType

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

(Inherited from Parameter)
DefaultValue DefaultValue DefaultValue 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.

(Inherited from Parameter)
Direction Direction Direction 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.

(Inherited from Parameter)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState 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.

(Inherited from Parameter)
IsTrackingViewState IsTrackingViewState IsTrackingViewState 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.

(Inherited from Parameter)
Name Name Name Name

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

(Inherited from Parameter)
Size Size Size Size

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

(Inherited from Parameter)
Type Type Type Type

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

(Inherited from Parameter)
ValidateInput ValidateInput ValidateInput 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 ViewState ViewState 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.

(Inherited from Parameter)

Methoden

Clone() Clone() Clone() Clone()

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

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
Evaluate(HttpContext, Control) Evaluate(HttpContext, Control) Evaluate(HttpContext, Control) Evaluate(HttpContext, Control)

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

GetDatabaseType() GetDatabaseType() GetDatabaseType() 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.

(Inherited from Parameter)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

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

(Inherited from Parameter)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnParameterChanged() OnParameterChanged() OnParameterChanged() 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.

(Inherited from Parameter)
SaveViewState() SaveViewState() SaveViewState() 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.

(Inherited from Parameter)
SetDirty() SetDirty() SetDirty() 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.

(Inherited from Parameter)
ToString() ToString() ToString() ToString()

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

(Inherited from Parameter)
TrackViewState() TrackViewState() TrackViewState() 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.

(Inherited from Parameter)

Explizite Schnittstellenimplementierungen

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

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

(Inherited from Parameter)
IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

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

(Inherited from Parameter)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() 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.

(Inherited from Parameter)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() 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.

(Inherited from Parameter)

Gilt für:

Siehe auch