CookieParameter Класс

Определение

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

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

Важно!

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

Привязывает значение http-файла 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 объект, привязанный к HTTP-файлу cookie, для отображения данных из базы данных 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 для привязки значения http-файла 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 класса, используя указанную строку, чтобы определить, к каким HTTP-файлам cookie необходимо привязаться.

Свойства

Имя	Описание
ConvertEmptyStringToNull	Возвращает или задает значение, указывающее, следует ли преобразовать объект Parameter в `null` значение, если оно есть Empty. (Унаследовано от Parameter)
CookieName	Возвращает или задает имя HTTP-файла cookie, к которому привязывается параметр.
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)

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

См. также раздел

Обратная связь

Были ли сведения на этой странице полезными?

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