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