CookieParameter Класс

Ссылка

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Привязывает значение файла cookie HTTP на стороне клиента к объекту параметра. Этот параметр может использоваться в параметризованном запросе или команде для выбора, фильтрации или обновления данных.

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

Наследование: Object

Parameter
CookieParameter

Примеры

В следующем примере кода показано, как использовать SqlDataSource элемент управления и CookieParameter объект, привязанный к файлу cookie HTTP, для отображения данных из базы данных Northwind Traders в элементе 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>

Класс можно использовать для привязки CookieParameter значения файла cookie HTTP на стороне клиента, передаваемого в рамках HTTP-запроса, к параметру, используемому ASP.NET элементами управления источником данных.

Класс CookieParameter предоставляет CookieName свойство , которое определяет имя объекта, HttpCookie к которому выполняется привязка, в дополнение к унаследованным от Parameter класса . Класс CookieParameter пытается выполнить привязку к именованным файлам cookie при каждом вызове Evaluate метода .

Важно!

Элементы управления, которые привязывают данные к параметру, могут вызвать исключение, если CookieParameter указан объект , но соответствующий файл cookie не передается с HTTP-запросом. Аналогичным образом, они могут не отображать данные, если файл cookie передается с nullпомощью . При необходимости задайте DefaultValue свойство , чтобы избежать таких ситуаций.

Конструкторы

CookieParameter()	Инициализирует новый безымянный экземпляр класса CookieParameter.
CookieParameter(CookieParameter)	Инициализирует новый экземпляр класса CookieParameter значениями экземпляра, заданного параметром `original`.
CookieParameter(String, DbType, String)	Инициализирует новый экземпляр класса CookieParameter, который имеет указанные имя и тип базы данных и привязан к заданному файлу Cookie HTTP.
CookieParameter(String, String)	Инициализирует новый именованный экземпляр класса CookieParameter, используя заданную строку для обозначения файла cookie HTTP, к которому выполняется привязка.
CookieParameter(String, TypeCode, String)	Инициализирует новый именованный и строго типизированный экземпляр класса CookieParameter, используя заданную строку для обозначения файла cookie HTTP, к которому выполняется привязка.

Свойства

ConvertEmptyStringToNull	Возвращает или задает значение, указывающее на необходимость преобразования значения, к которому привязан объект Parameter в `null`, если его значение равно Empty. (Унаследовано от Parameter)
CookieName	Возвращает или задает имя файла cookie HTTP, к которому привязывается параметр.
DbType	Возвращает или задает тип базы данных параметра. (Унаследовано от Parameter)
DefaultValue	Задает значение по умолчанию для параметра, если значение, к которому привязан параметр, должно быть инициализировано при вызове метода Evaluate(HttpContext, Control). (Унаследовано от Parameter)
Direction	Указывает, используется ли объект Parameter для привязки значения к элементу управления или же элемент управления можно использовать для изменения значения. (Унаследовано от Parameter)
IsTrackingViewState	Получает значение, указывающее сохраняет ли объект Parameter изменения в данных о состоянии представления. (Унаследовано от Parameter)
Name	Возвращает или задает имя параметра. (Унаследовано от Parameter)
Size	Возвращает или задает размер параметра. (Унаследовано от Parameter)
Type	Возвращает или задает тип параметра. (Унаследовано от Parameter)
ValidateInput	Получает или задает значение, указывающее, проверяется ли значение параметра.
ViewState	Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления объекта Parameter при нескольких запросах одной и той же страницы. (Унаследовано от Parameter)

Методы

Clone()	Возвращает дубликат текущего экземпляра CookieParameter.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Evaluate(HttpContext, Control)	Обновляет и возвращает значение объекта CookieParameter.
GetDatabaseType()	Возвращает значение DbType, эквивалентное типу среды CLR текущего экземпляра Parameter. (Унаследовано от Parameter)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
LoadViewState(Object)	Восстанавливает сохраненное раннее состояние представления источника данных. (Унаследовано от Parameter)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnParameterChanged()	Вызывает метод OnParametersChanged(EventArgs) коллекции ParameterCollection, содержащей объект Parameter. (Унаследовано от Parameter)
SaveViewState()	Сохраняет изменения в данных о состоянии представления объекта Parameter после обратной передачи страницы на сервер. (Унаследовано от Parameter)
SetDirty()	Обозначает объект Parameter как подлежащий записи его состояния в данные о состоянии представления. (Унаследовано от Parameter)
ToString()	Преобразует значение этого экземпляра в эквивалентное ему строковое представление. (Унаследовано от Parameter)
TrackViewState()	Инициирует отслеживание объектом Parameter изменений в состоянии его представления, благодаря чему их можно сохранить для этого объекта ViewState элемента управления и хранить их для всех запросов одной и той же страницы. (Унаследовано от Parameter)

Явные реализации интерфейса

ICloneable.Clone()	Возвращает дубликат текущего экземпляра Parameter. (Унаследовано от Parameter)
IStateManager.IsTrackingViewState	Получает значение, указывающее сохраняет ли объект Parameter изменения в данных о состоянии представления. (Унаследовано от Parameter)
IStateManager.LoadViewState(Object)	Восстанавливает сохраненное раннее состояние представления источника данных. (Унаследовано от Parameter)
IStateManager.SaveViewState()	Сохраняет изменения в данных о состоянии представления объекта Parameter после обратной передачи страницы на сервер. (Унаследовано от Parameter)
IStateManager.TrackViewState()	Инициирует отслеживание объектом Parameter изменений в состоянии его представления, благодаря чему их можно сохранить для этого объекта ViewState элемента управления и хранить их для всех запросов одной и той же страницы. (Унаследовано от Parameter)

Применяется к

Поделиться через