CookieParameter Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
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ą null
polecenia . Ustaw właściwość , DefaultValue aby uniknąć takich sytuacji, jeśli jest to konieczne.
Konstruktory
CookieParameter() |
Inicjuje CookieParameter nowe, nienazwane wystąpienie klasy . |
CookieParameter(CookieParameter) |
Inicjuje nowe wystąpienie CookieParameter klasy z wartościami wystąpienia określonego |
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
ConvertEmptyStringToNull |
Pobiera lub ustawia wartość wskazującą, czy wartość, Parameter z którą obiekt jest powiązany, powinna zostać przekonwertowana na |
CookieName |
Pobiera lub ustawia nazwę pliku cookie HTTP, z którą jest powiązany parametr. |
DbType |
Pobiera lub ustawia typ bazy danych parametru. (Odziedziczone po Parameter) |
DefaultValue |
Określa wartość domyślną parametru, jeśli wartość parametru jest powiązana z niezainicjowanym podczas wywoływania Evaluate(HttpContext, Control) metody. (Odziedziczone po 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. (Odziedziczone po Parameter) |
IsTrackingViewState |
Pobiera wartość wskazującą, czy Parameter obiekt zapisuje zmiany w stanie widoku. (Odziedziczone po Parameter) |
Name |
Pobiera lub ustawia nazwę parametru. (Odziedziczone po Parameter) |
Size |
Pobiera lub ustawia rozmiar parametru. (Odziedziczone po Parameter) |
Type |
Pobiera lub ustawia typ parametru. (Odziedziczone po 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. (Odziedziczone po Parameter) |
Metody
Clone() |
Zwraca duplikat bieżącego CookieParameter wystąpienia. |
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
Evaluate(HttpContext, Control) |
Aktualizacje i zwraca wartość CookieParameter obiektu. |
GetDatabaseType() |
DbType Pobiera wartość równoważną typowi CLR bieżącego Parameter wystąpienia. (Odziedziczone po Parameter) |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
LoadViewState(Object) |
Przywraca wcześniej zapisany stan widoku źródła danych. (Odziedziczone po Parameter) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
OnParameterChanged() |
Wywołuje metodę OnParametersChanged(EventArgs) kolekcji ParameterCollection zawierającej Parameter obiekt . (Odziedziczone po Parameter) |
SaveViewState() |
Zapisuje zmiany Parameter stanu widoku obiektu od momentu opublikowania strony z powrotem na serwerze. (Odziedziczone po Parameter) |
SetDirty() |
Oznacza obiekt tak Parameter , aby jego stan był rejestrowany w stanie widoku. (Odziedziczone po Parameter) |
ToString() |
Konwertuje wartość tego wystąpienia na jego równoważną reprezentację w postaci ciągu. (Odziedziczone po 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. (Odziedziczone po Parameter) |
Jawne implementacje interfejsu
ICloneable.Clone() |
Zwraca duplikat bieżącego Parameter wystąpienia. (Odziedziczone po Parameter) |
IStateManager.IsTrackingViewState |
Pobiera wartość wskazującą, czy Parameter obiekt zapisuje zmiany w stanie widoku. (Odziedziczone po Parameter) |
IStateManager.LoadViewState(Object) |
Przywraca wcześniej zapisany stan widoku źródła danych. (Odziedziczone po Parameter) |
IStateManager.SaveViewState() |
Zapisuje zmiany Parameter stanu widoku obiektu od momentu opublikowania strony z powrotem na serwerze. (Odziedziczone po 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. (Odziedziczone po Parameter) |