QueryStringParameter Класс

Ссылка

Определение

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

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

Важно!

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

Привязывает значение поля запроса HTTP-запроса к объекту параметра.

public ref class QueryStringParameter : System::Web::UI::WebControls::Parameter

public class QueryStringParameter : System.Web.UI.WebControls.Parameter

type QueryStringParameter = class
    inherit Parameter

Public Class QueryStringParameter
Inherits Parameter

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

Parameter
QueryStringParameter

Примеры

В следующем примере показано, как создать объект QueryStringParameter для использования в качестве фильтра при отображении данных в элементе управления GridView. Вы добавляете объект QueryStringParameter в коллекцию FilterParameters элемента управления AccessDataSource. Объект параметра привязывает значение поля строки запроса с именем country к строке FilterExpression. Так как для параметра не указано свойство DefaultValue, если поле с именем country не передается со строкой запроса, элемент управления AccessDataSource вызывает исключение NullReferenceException. Если поле с именем country передается, но не имеет значения, элемент управления GridView не отображает данные.

<%@ Page language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>
    </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">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>

    </form>
  </body>
</html>

Класс QueryStringParameter можно использовать для привязки значения поля, передаваемого в рамках строки запроса HTTP-запроса, к параметру, используемому в параметризованном запросе или команде. Поле извлекается из коллекции QueryString.

Элементы управления, которые привязывают данные к параметру, могут вызвать исключение, если ссылка на объект QueryStringParameter, но не передается соответствующая пара имени и значения запроса. Аналогичным образом они могут отображать данные, если имя поля строки запроса передается без соответствующего значения. Чтобы избежать этих ситуаций, задайте свойство DefaultValue, если это необходимо.

Класс QueryStringParameter предоставляет свойство QueryStringField, определяющее имя значения строки запроса для привязки. Он также предоставляет свойства, унаследованные от класса Parameter.

Важный

Класс QueryStringParameter не проверяет переданное значение; он предоставляет необработанное значение. Однако можно проверить значение объекта QueryStringParameter в элементе управления версиями данных. Для этого обработайте событие Selecting, Updating, Insertingили Deleting элемента управления источниками данных и проверьте значение параметра в обработчике событий. Если значение параметра не передает тесты проверки, можно отменить операцию данных, задав для свойства Cancel связанного класса CancelEventArgs значение true.

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

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

Свойства

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

Методы

Clone()	Возвращает дубликат текущего экземпляра QueryStringParameter.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Evaluate(HttpContext, Control)	Обновляет и возвращает значение объекта QueryStringParameter.
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)

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

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