RouteParameter RouteParameter RouteParameter RouteParameter Class

Определение

Привязывает значение сегмента 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
Наследование
RouteParameterRouteParameterRouteParameterRouteParameter

Примеры

Примеры в этом разделе показано, как использовать 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.

В следующем примере показана страница с именем ProductLinks.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 параметр запроса будет использоваться в запросе.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 nameName ОписаниеDescription
994 LL Bottom Bracket Chromoly steel.

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

ProductIDProductID nameName Описание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 Web сайта с исходным кодом доступен на следующей странице в этом разделе: Скачайте.A Visual Studio Web site project with source code is available to accompany this topic: Download.

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

RouteParameter() RouteParameter() RouteParameter() RouteParameter()

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

RouteParameter(RouteParameter) RouteParameter(RouteParameter) RouteParameter(RouteParameter) RouteParameter(RouteParameter)

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

RouteParameter(String, DbType, String) RouteParameter(String, DbType, String) RouteParameter(String, DbType, String) 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(String, String) RouteParameter(String, String) 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(String, TypeCode, String) RouteParameter(String, TypeCode, String) 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 ConvertEmptyStringToNull ConvertEmptyStringToNull 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.

(Inherited from Parameter)
DbType DbType DbType DbType

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

(Inherited from Parameter)
DefaultValue DefaultValue DefaultValue 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.

(Inherited from Parameter)
Direction Direction Direction 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.

(Inherited from Parameter)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

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

(Inherited from Parameter)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

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

(Inherited from Parameter)
Name Name Name Name

Получает или задает имя параметра.Gets or sets the name of the parameter.

(Inherited from Parameter)
RouteKey RouteKey RouteKey RouteKey

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

Size Size Size Size

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

(Inherited from Parameter)
Type Type Type Type

Получает или задает тип параметра.Gets or sets the type of the parameter.

(Inherited from Parameter)
ViewState ViewState ViewState 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.

(Inherited from Parameter)

Методы

Clone() Clone() Clone() Clone()

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

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
Evaluate(HttpContext, Control) Evaluate(HttpContext, Control) Evaluate(HttpContext, Control) Evaluate(HttpContext, Control)

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

GetDatabaseType() GetDatabaseType() GetDatabaseType() GetDatabaseType()

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

(Inherited from Parameter)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

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

(Inherited from Parameter)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnParameterChanged() OnParameterChanged() OnParameterChanged() OnParameterChanged()

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

(Inherited from Parameter)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

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

(Inherited from Parameter)
SetDirty() SetDirty() SetDirty() SetDirty()

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

(Inherited from Parameter)
ToString() ToString() ToString() ToString()

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

(Inherited from Parameter)
TrackViewState() TrackViewState() TrackViewState() 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.

(Inherited from Parameter)

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

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

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

(Inherited from Parameter)
IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

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

(Inherited from Parameter)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

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

(Inherited from Parameter)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() 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.

(Inherited from Parameter)

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

Дополнительно