RouteParameter Класс

Определение

Пространство имен:

System.Web.UI.WebControls

Сборка:

System.Web.dll

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

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

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

type RouteParameter = class
    inherit Parameter

Public Class RouteParameter
Inherits Parameter

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

Object

Parameter

RouteParameter

Примеры

В примерах в этом разделе показано, как использовать RouteParameter объекты в разметке для передачи значений параметров URL-адреса в запрос, указанный для элемента управления источником данных.

В следующем примере показан код на странице Global.asax, определяющий маршрут с именем ProductRoute. Маршрут определяет параметр URL-адреса с именем productname. Маршрут также определяет необязательный параметр catchall с именем culture, который можно использовать для указания языка, на котором отображается описание продукта. Страница Product.aspx обрабатывает запросы для этого маршрута.

В следующем примере показана страница Product.aspx. Страница содержит SqlDataSource элемент управления, содержащий запрос, для которого требуются два параметра: один для названия продукта, а второй — для языка описания продукта. RouteParameter объекты используются для предоставления значений для параметров запроса. Значение параметра productname URL-адреса маршрута передается параметру @productnameзапроса . Значение параметра culture URL-адреса маршрута передается параметру @cultureзапроса . Если URL-адрес маршрута не содержит параметр cultureURL, используется значение по умолчанию en.

В следующем примере показана страница с именем ProductLinks.aspx, которая содержит гиперссылки, ссылающиеся на страницу Product.aspx с помощью URL-адресов маршрута. Эти гиперссылки используют RouteUrl выражения для создания URL-адресов маршрутов. Первая ссылка не содержит culture параметр маршрута. Поэтому в запросе будет использоваться значение по умолчанию en, определенное RouteParameter в объекте для @culture параметра запроса. Вторая ссылка предоставляет culture значение "fr", которое приводит к отображению описания на французском языке. Дополнительные сведения об использовании RouteUrl выражений см. в разделе Практическое руководство. Создание URL-адресов из маршрутов.

Щелкнув первую гиперссылку, вы увидите страницу Product.aspx со следующими значениями в элементе GridView управления :

ProductID	Имя	Описание:
994	LL Bottom Bracket	Chromoly steel.

Щелкнув вторую гиперссылку, в элементе GridView управления отображаются следующие значения:

ProductID	Имя	Описание:
994	LL Bottom Bracket	Acier chromé.

Чтобы выполнить этот пример, добавьте две ASPX-страницы и код в файле Global.asax на веб-сайт ASP.NET или веб-приложение, которое определяет строку AdventureWorksLTConnectionString подключения для базы данных AdventureWorksLT. Сведения о настройке подключения к базе данных AdventureWorksLT см. в разделе How to: Set Up an AdventureWorksLT Sample Database for ASP.NET Development.

Дополнительные сведения о маршрутизации ASP.NET см. в статье Маршрутизация ASP.NET.

Комментарии

При реализации маршрутизации ASP.NET на веб-сайте объект можно использовать RouteParameter для привязки значения сегмента запрошенного URL-адреса к запросу или команде базы данных. Объекты можно объявить RouteParameter в разметке для элементов управления источником данных или QueryExtender элемента управления .

Проект веб-сайта Visual Studio с исходным кодом доступен в следующем разделе: Скачивание.

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

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

Свойства

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

Методы

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

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

• QueryExtender
• Общие сведения о серверных веб-элементах управления QueryExtender