CookieParameter Klas

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee wordt de waarde van een HTTP-cookie aan de clientzijde gekoppeld aan een parameterobject. De parameter kan worden gebruikt in een geparameteriseerde query of opdracht om gegevens te selecteren, te filteren of bij te werken.

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

Overname: Object

Parameter
CookieParameter

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een SqlDataSource besturingselement en CookieParameter object gebruikt dat is gebonden aan een HTTP-cookie om gegevens uit de Northwind Traders-database in een GridView besturingselement weer te geven.

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

Opmerkingen

U kunt de klasse CookieParameter gebruiken om de waarde van een HTTP-cookie aan de clientzijde te binden die als onderdeel van een HTTP-aanvraag wordt doorgegeven aan een parameter die wordt gebruikt door ASP.NET besturingselementen voor gegevensbronnen.

De CookieParameter klasse biedt de CookieName eigenschap, waarmee de naam van het HttpCookie object wordt geïdentificeerd waaraan moet worden gekoppeld, naast de namen die zijn overgenomen van de Parameter klasse. De CookieParameter klasse probeert elke keer dat de Evaluate methode wordt aangeroepen, aan de benoemde cookie te binden.

Important

Besturingselementen waarmee gegevens aan de parameter worden gebonden, kunnen een uitzondering genereren als er een CookieParameter object is opgegeven, maar er geen bijbehorende cookie wordt doorgegeven aan de HTTP-aanvraag. Op dezelfde manier kunnen ze geen gegevens weergeven als de cookie wordt doorgegeven met null. Stel de DefaultValue eigenschap in om deze situaties te voorkomen, indien van toepassing.

Constructors

Name	Description
CookieParameter()	Initialiseert een nieuw niet-benoemd exemplaar van de CookieParameter klasse.
CookieParameter(CookieParameter)	Initialiseert een nieuw exemplaar van de CookieParameter klasse met de waarden van het exemplaar dat is opgegeven door de `original` parameter.
CookieParameter(String, DbType, String)	Initialiseert een nieuw exemplaar van de CookieParameter klasse met de opgegeven naam en het databasetype en dat is gebonden aan de opgegeven HTTP-cookie.
CookieParameter(String, String)	Initialiseert een nieuw benoemd exemplaar van de CookieParameter klasse met behulp van de opgegeven tekenreeks om te bepalen aan welke HTTP-cookie moet worden gebonden.
CookieParameter(String, TypeCode, String)	Initialiseert een nieuwe benoemde en sterk getypte instantie van de CookieParameter klasse met behulp van de opgegeven tekenreeks om te bepalen aan welke HTTP-cookie moet worden gebonden.

Eigenschappen

Name	Description
ConvertEmptyStringToNull	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de waarde waarnaar het Parameter object is gebonden, moet worden geconverteerd `null` als dit het geval is Empty. (Overgenomen van Parameter)
CookieName	Hiermee haalt u de naam op van de HTTP-cookie waaraan de parameter wordt gekoppeld.
DbType	Hiermee haalt u het databasetype van de parameter op of stelt u deze in. (Overgenomen van Parameter)
DefaultValue	Hiermee geeft u een standaardwaarde voor de parameter op, moet de waarde die de parameter moet worden niet geïnitialiseerd wanneer de Evaluate(HttpContext, Control) methode wordt aangeroepen. (Overgenomen van Parameter)
Direction	Hiermee wordt aangegeven of het Parameter object wordt gebruikt om een waarde aan een besturingselement te binden, of het besturingselement kan worden gebruikt om de waarde te wijzigen. (Overgenomen van Parameter)
IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het Parameter object wijzigingen opslaat in de weergavestatus. (Overgenomen van Parameter)
Name	Hiermee haalt u de naam van de parameter op of stelt u deze in. (Overgenomen van Parameter)
Size	Hiermee haalt u de grootte van de parameter op of stelt u deze in. (Overgenomen van Parameter)
Type	Hiermee haalt u het type van de parameter op of stelt u deze in. (Overgenomen van Parameter)
ValidateInput	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de waarde van de parameter wordt gevalideerd.
ViewState	Hiermee haalt u een woordenlijst met statusgegevens op waarmee u de weergavestatus van een Parameter object kunt opslaan en herstellen voor meerdere aanvragen voor dezelfde pagina. (Overgenomen van Parameter)

Methoden

Name	Description
Clone()	Retourneert een duplicaat van het huidige CookieParameter exemplaar.
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
Evaluate(HttpContext, Control)	Hiermee wordt de waarde van het CookieParameter object bijgewerkt en geretourneerd.
GetDatabaseType()	Hiermee haalt u de DbType waarde op die gelijk is aan het CLR-type van het huidige Parameter exemplaar. (Overgenomen van Parameter)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
LoadViewState(Object)	Hiermee herstelt u de eerder opgeslagen weergavestatus van de gegevensbronweergave. (Overgenomen van Parameter)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnParameterChanged()	Roept de OnParametersChanged(EventArgs) methode aan van de ParameterCollection verzameling die het Parameter object bevat. (Overgenomen van Parameter)
SaveViewState()	Hiermee worden de wijzigingen opgeslagen in de weergavestatus van het Parameter object sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van Parameter)
SetDirty()	Hiermee wordt het Parameter object gemarkeerd, zodat de status ervan wordt vastgelegd in de weergavestatus. (Overgenomen van Parameter)
ToString()	Converteert de waarde van dit exemplaar naar de equivalente tekenreeksweergave. (Overgenomen van Parameter)
TrackViewState()	Hiermee zorgt u ervoor dat het Parameter object wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in het object van ViewState het besturingselement en kunnen worden bewaard in aanvragen voor dezelfde pagina. (Overgenomen van Parameter)

Expliciete interface-implementaties

Name	Description
ICloneable.Clone()	Retourneert een duplicaat van het huidige Parameter exemplaar. (Overgenomen van Parameter)
IStateManager.IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het Parameter object wijzigingen opslaat in de weergavestatus. (Overgenomen van Parameter)
IStateManager.LoadViewState(Object)	Hiermee herstelt u de eerder opgeslagen weergavestatus van de gegevensbronweergave. (Overgenomen van Parameter)
IStateManager.SaveViewState()	Hiermee worden de wijzigingen opgeslagen in de weergavestatus van het Parameter object sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van Parameter)
IStateManager.TrackViewState()	Hiermee zorgt u ervoor dat het Parameter object wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in het object van ViewState het besturingselement en kunnen worden bewaard in aanvragen voor dezelfde pagina. (Overgenomen van Parameter)

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?