RouteParameter Класс

Определение

Привязывает значение сегмента URL-адреса к объекту параметра.Binds the value of a URL segment to a parameter object.

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
Наследование
RouteParameter

Примеры

Примеры в этом разделе показывают, как использовать RouteParameter объекты в разметке для передачи значений параметров URL-адреса в запрос, указанный для элемента управления источника данных.The examples in this section show how to use RouteParameter objects in markup to pass URL parameter values to a query that is specified for a data source control.

В следующем примере показан код на странице Global. asax, который определяет маршрут с именем ProductRoute .The following example shows code in the Global.asax page that defines a route that is named ProductRoute. Маршрут определяет параметр URL-адреса с именем productname .The route defines a URL parameter that is named productname. Маршрут также определяет необязательный параметр общего имени, который culture можно использовать для указания языка, на котором отображается описание продукта.The route also defines an optional catchall parameter that is named culture, which can be used to specify the language in which the product description is displayed. Страница Product. aspx обрабатывает запросы для этого маршрута.The Product.aspx page handles requests for this route.

В следующем примере показана страница Product. aspx.The following example shows the Product.aspx page. Страница содержит SqlDataSource элемент управления с запросом, для которого требуются два параметра: один для имени продукта и один для языка описания продукта.The page contains a SqlDataSource control that has a query that requires two parameters, one for the name of the product and one for the language of the product description. RouteParameter объекты используются для предоставления значений для параметров запроса.RouteParameter objects are used to supply the values for the query parameters. Значение параметра URL-адреса маршрута productname передается в параметр запроса @productname .The value of the route URL parameter productname is passed to the query parameter @productname. Значение параметра URL-адреса маршрута culture передается в параметр запроса @culture .The value of the route URL parameter culture is passed to the query parameter @culture. Если URL-адрес маршрута не включает параметр URL-адреса culture , используется значение по умолчанию EN.If a route URL does not include the URL parameter culture, a default value of "en" is used.

В следующем примере показана страница с именем Продуктлинкс. aspx, которая содержит гиперссылки, которые связываются со страницей Product. aspx с помощью URL-адресов маршрутов.The following example shows a page that is named ProductLinks.aspx, which contains hyperlinks that link to the Product.aspx page by using route URLs. Эти гиперссылки используют RouteUrl выражения для создания URL-адресов маршрутов.These hyperlinks use RouteUrl expressions to create route URLs. Первая ссылка не включает culture параметр маршрута.The first link does not include a culture route parameter. Таким образом, значение по умолчанию EN, определенное в RouteParameter @culture параметре Object для запроса, будет использоваться в запросе.Therefore, the default value of "en" that is defined in the RouteParameter object for @culture query parameter will be used in the query. Вторая ссылка дает culture значение fr, что приводит к отображению описания на французском языке.The second link provides a culture value of "fr", which causes the description to be displayed in French. Дополнительные сведения об использовании RouteUrl выражений см. в разделе инструкции. Создание URL-адресов из маршрутов.For more information about how to use RouteUrl expressions, see How to: Construct URLs from Routes.

Щелкнув первую гиперссылку, вы увидите страницу Product. aspx со следующими значениями в GridView элементе управления:When you click the first hyperlink, you see the Product.aspx page with the following values in the GridView control:

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

Щелкнув вторую гиперссылку, вы увидите в GridView элементе управления следующие значения:When you click the second hyperlink, you see the following values in the GridView control:

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

Чтобы выполнить этот пример, добавьте две страницы ASPX и код из файла Global. asax на веб-сайт ASP.NET или веб-приложение, которое определяет строку подключения с именем AdventureWorksLTConnectionString для базы данных AdventureWorksLT.To run this example, add the two .aspx pages and the code in the Global.asax file to an ASP.NET Web site or Web application that defines a connection string named AdventureWorksLTConnectionString for the AdventureWorksLT database. Дополнительные сведения о настройке подключения к базе данных AdventureWorksLT см. в разделе как настроить образец базы данных AdventureWorksLT для разработки ASP.NET.For information about how to set up a connection to the AdventureWorksLT database, see How to: Set Up an AdventureWorksLT Sample Database for ASP.NET Development.

Дополнительные сведения о маршрутизации ASP.NET см. в разделе маршрутизация ASP.NET.For more information about ASP.NET routing, see ASP.NET Routing.

Комментарии

При реализации маршрутизации ASP.NET на веб-сайте можно использовать RouteParameter объект для привязки значения сегмента запрошенного URL-адреса к запросу или команде базы данных.If you implement ASP.NET routing in a Web site, you can use the RouteParameter object to bind the value of a segment of the requested URL to a database query or command. Объекты можно объявить RouteParameter в разметке для элементов управления источника данных или QueryExtender элемента управления.You can declare RouteParameter objects in markup for data source controls or the QueryExtender control.

Проект веб-сайта Visual Studio с исходным кодом можно найти в этой статье: download.A Visual Studio Web site project with source code is available to accompany this topic: Download.

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

RouteParameter()

Инициализирует новый экземпляр класса RouteParameter.Initializes a new instance of the RouteParameter class.

RouteParameter(RouteParameter)

Инициализирует новый экземпляр RouteParameter, используя значения заданного экземпляра.Initializes a new instance of the RouteParameter class by using the values of the specified instance.

RouteParameter(String, DbType, String)

Инициализирует новый экземпляр класса RouteParameter, используя заданные имя и тип базы данных в качестве параметра и заданный ключ в качестве данных маршрута.Initializes a new instance of the RouteParameter class by using the specified name and database type for the parameter, and by using the specified key for the route data.

RouteParameter(String, String)

Инициализирует новый экземпляр класса RouteParameter, используя заданное имя в качестве параметра и заданный ключ в качестве данных маршрута.Initializes a new instance of the RouteParameter class by using the specified name for the parameter and the specified key for route data.

RouteParameter(String, TypeCode, String)

Инициализирует новый экземпляр класса RouteParameter, используя заданные имя и тип в качестве параметра и заданный ключ в качестве данных маршрута.Initializes a new instance of the RouteParameter class by using the specified name and type for the parameter, and by using the specified key for the route data.

Свойства

ConvertEmptyStringToNull

Возвращает или задает значение, указывающее на необходимость преобразования значения, к которому привязан объект Parameter в null, если его значение равно Empty.Gets or sets a value indicating whether the value that the Parameter object is bound to should be converted to null if it is Empty.

(Унаследовано от Parameter)
DbType

Возвращает или задает тип базы данных параметра.Gets or sets the database type of the parameter.

(Унаследовано от Parameter)
DefaultValue

Задает значение по умолчанию для параметра, если значение, к которому привязан параметр, должно быть инициализировано при вызове метода Evaluate(HttpContext, Control).Specifies a default value for the parameter, should the value that the parameter is bound to be uninitialized when the Evaluate(HttpContext, Control) method is called.

(Унаследовано от Parameter)
Direction

Указывает, используется ли объект Parameter для привязки значения к элементу управления или же элемент управления можно использовать для изменения значения.Indicates whether the Parameter object is used to bind a value to a control, or the control can be used to change the value.

(Унаследовано от Parameter)
IsTrackingViewState

Получает значение, указывающее сохраняет ли объект Parameter изменения в данных о состоянии представления.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Унаследовано от Parameter)
Name

Возвращает или задает имя параметра.Gets or sets the name of the parameter.

(Унаследовано от Parameter)
RouteKey

Получает или задает имя сегмента маршрута, из которого извлекается значение для параметра маршрута.Gets or sets the name of the route segment from which to retrieve the value for the route parameter.

Size

Возвращает или задает размер параметра.Gets or sets the size of the parameter.

(Унаследовано от Parameter)
Type

Возвращает или задает тип параметра.Gets or sets the type of the parameter.

(Унаследовано от Parameter)
ViewState

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления объекта Parameter при нескольких запросах одной и той же страницы.Gets a dictionary of state information that allows you to save and restore the view state of a Parameter object across multiple requests for the same page.

(Унаследовано от Parameter)

Методы

Clone()

Возвращает дубликат текущего экземпляра RouteParameter.Returns a duplicate of the current RouteParameter instance.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
Evaluate(HttpContext, Control)

Вычисляет URL-адрес запроса и возвращает значение параметра.Evaluates the request URL and returns the value of the parameter.

GetDatabaseType()

Возвращает значение DbType, эквивалентное типу среды CLR текущего экземпляра Parameter.Gets the DbType value that is equivalent to the CLR type of the current Parameter instance.

(Унаследовано от Parameter)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
LoadViewState(Object)

Восстанавливает сохраненное раннее состояние представления источника данных.Restores the data source view's previously saved view state.

(Унаследовано от Parameter)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnParameterChanged()

Вызывает метод OnParametersChanged(EventArgs) коллекции ParameterCollection, содержащей объект Parameter.Calls the OnParametersChanged(EventArgs) method of the ParameterCollection collection that contains the Parameter object.

(Унаследовано от Parameter)
SaveViewState()

Сохраняет изменения в данных о состоянии представления объекта Parameter после обратной передачи страницы на сервер.Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(Унаследовано от Parameter)
SetDirty()

Обозначает объект Parameter как подлежащий записи его состояния в данные о состоянии представления.Marks the Parameter object so its state will be recorded in view state.

(Унаследовано от Parameter)
ToString()

Преобразует значение этого экземпляра в эквивалентное ему строковое представление.Converts the value of this instance to its equivalent string representation.

(Унаследовано от Parameter)
TrackViewState()

Инициирует отслеживание объектом Parameter изменений в состоянии его представления, благодаря чему их можно сохранить для этого объекта ViewState элемента управления и хранить их для всех запросов одной и той же страницы.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page.

(Унаследовано от Parameter)

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

ICloneable.Clone()

Возвращает дубликат текущего экземпляра Parameter.Returns a duplicate of the current Parameter instance.

(Унаследовано от Parameter)
IStateManager.IsTrackingViewState

Получает значение, указывающее сохраняет ли объект Parameter изменения в данных о состоянии представления.Gets a value indicating whether the Parameter object is saving changes to its view state.

(Унаследовано от Parameter)
IStateManager.LoadViewState(Object)

Восстанавливает сохраненное раннее состояние представления источника данных.Restores the data source view's previously saved view state.

(Унаследовано от Parameter)
IStateManager.SaveViewState()

Сохраняет изменения в данных о состоянии представления объекта Parameter после обратной передачи страницы на сервер.Saves the changes to the Parameter object's view state since the time the page was posted back to the server.

(Унаследовано от Parameter)
IStateManager.TrackViewState()

Инициирует отслеживание объектом Parameter изменений в состоянии его представления, благодаря чему их можно сохранить для этого объекта ViewState элемента управления и хранить их для всех запросов одной и той же страницы.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page.

(Унаследовано от Parameter)

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

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