CookieParameter Klasa

Definicja

Namespace:: System.Web.UI.WebControls

Montaż:: System.Web.dll

Ważny

Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.

Wiąże wartość pliku cookie HTTP po stronie klienta z obiektem parametru. Parametr może być używany w sparametryzowanym zapytaniu lub poleceniu do wybierania, filtrowania lub aktualizowania danych.

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

Dziedziczenie: Object

Parameter
CookieParameter

Przykłady

W poniższym przykładzie kodu pokazano, jak używać SqlDataSource kontrolki i CookieParameter obiektu powiązanego z plikiem cookie HTTP do wyświetlania danych z bazy danych Northwind Traders w kontrolce GridView .

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

Uwagi

Za pomocą CookieParameter klasy można powiązać wartość pliku cookie HTTP po stronie klienta przekazanego w ramach żądania HTTP do parametru używanego przez kontrolki źródła danych ASP.NET.

Klasa CookieParameter udostępnia CookieName właściwość , która identyfikuje nazwę HttpCookie obiektu, z którym ma być powiązana, oprócz tych dziedziczynych z Parameter klasy. Klasa CookieParameter próbuje powiązać z nazwanym plikiem cookie za każdym razem, gdy metoda jest wywoływana Evaluate .

Ważne

Kontrolki, które wiążą dane z parametrem, mogą zgłaszać wyjątek, jeśli CookieParameter określono obiekt, ale nie jest przekazywany odpowiedni plik cookie z żądaniem HTTP. Podobnie mogą nie wyświetlać żadnych danych, jeśli plik cookie zostanie przekazany za pomocą nullpolecenia . Ustaw właściwość , DefaultValue aby uniknąć takich sytuacji, jeśli jest to konieczne.

Konstruktorów

Nazwa	Opis
CookieParameter()	Inicjuje CookieParameter nowe, nienazwane wystąpienie klasy .
CookieParameter(CookieParameter)	Inicjuje nowe wystąpienie CookieParameter klasy z wartościami wystąpienia określonego `original` przez parametr .
CookieParameter(String, DbType, String)	Inicjuje CookieParameter nowe wystąpienie klasy o określonej nazwie i typie bazy danych, które jest powiązane z określonym plikiem cookie HTTP.
CookieParameter(String, String)	Inicjuje CookieParameter nowe nazwane wystąpienie klasy przy użyciu określonego ciągu w celu zidentyfikowania pliku cookie HTTP, z którym ma być powiązane.
CookieParameter(String, TypeCode, String)	Inicjuje nowe nazwane i silnie typizowane wystąpienie CookieParameter klasy przy użyciu określonego ciągu w celu zidentyfikowania pliku cookie HTTP, z którym ma być powiązane.

Właściwości

Nazwa	Opis
ConvertEmptyStringToNull	Pobiera lub ustawia wartość wskazującą, czy wartość, Parameter z którą obiekt jest powiązany, powinna zostać przekonwertowana na `null` wartość , jeśli jest Emptyto . (Dziedziczone od Parameter)
CookieName	Pobiera lub ustawia nazwę pliku cookie HTTP, z którą jest powiązany parametr.
DbType	Pobiera lub ustawia typ bazy danych parametru. (Dziedziczone od Parameter)
DefaultValue	Określa wartość domyślną parametru, jeśli wartość parametru jest powiązana z niezainicjowanym podczas wywoływania Evaluate(HttpContext, Control) metody. (Dziedziczone od Parameter)
Direction	Wskazuje, czy Parameter obiekt jest używany do powiązania wartości z kontrolką, czy kontrolki można użyć do zmiany wartości. (Dziedziczone od Parameter)
IsTrackingViewState	Pobiera wartość wskazującą, czy Parameter obiekt zapisuje zmiany w stanie widoku. (Dziedziczone od Parameter)
Name	Pobiera lub ustawia nazwę parametru. (Dziedziczone od Parameter)
Size	Pobiera lub ustawia rozmiar parametru. (Dziedziczone od Parameter)
Type	Pobiera lub ustawia typ parametru. (Dziedziczone od Parameter)
ValidateInput	Pobiera lub ustawia wartość określającą, czy wartość parametru jest weryfikowana.
ViewState	Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu Parameter widoku obiektu w wielu żądaniach dla tej samej strony. (Dziedziczone od Parameter)

Metody

Nazwa	Opis
Clone()	Zwraca duplikat bieżącego CookieParameter wystąpienia.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Dziedziczone od Object)
Evaluate(HttpContext, Control)	Aktualizacje i zwraca wartość CookieParameter obiektu.
GetDatabaseType()	DbType Pobiera wartość równoważną typowi CLR bieżącego Parameter wystąpienia. (Dziedziczone od Parameter)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Dziedziczone od Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Dziedziczone od Object)
LoadViewState(Object)	Przywraca wcześniej zapisany stan widoku źródła danych. (Dziedziczone od Parameter)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object)
OnParameterChanged()	Wywołuje metodę OnParametersChanged(EventArgs) kolekcji ParameterCollection zawierającej Parameter obiekt . (Dziedziczone od Parameter)
SaveViewState()	Zapisuje zmiany Parameter stanu widoku obiektu od momentu opublikowania strony z powrotem na serwerze. (Dziedziczone od Parameter)
SetDirty()	Oznacza obiekt tak Parameter , aby jego stan był rejestrowany w stanie widoku. (Dziedziczone od Parameter)
ToString()	Konwertuje wartość tego wystąpienia na jego równoważną reprezentację w postaci ciągu. (Dziedziczone od Parameter)
TrackViewState()	Parameter Powoduje, że obiekt śledzi zmiany stanu widoku, dzięki czemu można je przechowywać w obiekcie kontrolki ViewState i utrwalać w żądaniach dla tej samej strony. (Dziedziczone od Parameter)

Implementacje interfejsów jawnych

Nazwa	Opis
ICloneable.Clone()	Zwraca duplikat bieżącego Parameter wystąpienia. (Dziedziczone od Parameter)
IStateManager.IsTrackingViewState	Pobiera wartość wskazującą, czy Parameter obiekt zapisuje zmiany w stanie widoku. (Dziedziczone od Parameter)
IStateManager.LoadViewState(Object)	Przywraca wcześniej zapisany stan widoku źródła danych. (Dziedziczone od Parameter)
IStateManager.SaveViewState()	Zapisuje zmiany Parameter stanu widoku obiektu od momentu opublikowania strony z powrotem na serwerze. (Dziedziczone od Parameter)
IStateManager.TrackViewState()	Parameter Powoduje, że obiekt śledzi zmiany stanu widoku, dzięki czemu można je przechowywać w obiekcie kontrolki ViewState i utrwalać w żądaniach dla tej samej strony. (Dziedziczone od Parameter)

Dotyczy

Zobacz także

Sprzężenie zwrotne

Czy ta strona była pomocna?