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路由。 路由定义名为 的 productnameURL 参数。 路由还定义了一 culture个名为 的可选 catchall 参数，该参数可用于指定显示产品说明的语言。 Product.aspx 页处理此路由的请求。

以下示例显示 Product.aspx 页。 该页包含一个 SqlDataSource 控件，该控件的查询需要两个参数，一个参数用于产品名称，另一个参数用于产品说明的语言。 RouteParameter 对象用于提供查询参数的值。 路由 URL 参数 productname 的值将传递给查询参数 @productname。 路由 URL 参数 culture 的值将传递给查询参数 @culture。 如果路由 URL 不包括 URL 参数 culture，则使用默认值“en”。

以下示例显示名为 ProductLinks.aspx 的页面，其中包含使用路由 URL 链接到 Product.aspx 页面的超链接。 这些超链接使用 RouteUrl 表达式创建路由 URL。 第一个 culture 链接不包括路由参数。 因此，查询参数的 对象@culture中RouteParameter定义的默认值“en”将在查询中使用。 第二个 culture 链接提供值“fr”，这会导致说明以法语显示。 有关如何使用 RouteUrl 表达式的详细信息，请参阅 如何：从路由构造 URL。

单击第一个超链接时，会看到 Product.aspx 页在 GridView 控件中包含以下值：

ProductID	名称	说明
994	LL Bottom Bracket	Chromoly steel.

单击第二个超链接时，可在 控件中看到 GridView 以下值：

ProductID	名称	说明
994	LL Bottom Bracket	Acier chromé.

若要运行此示例，请将 Global.asax 文件中的两个 .aspx 页和代码添加到为 AdventureWorksLT 数据库定义名为 AdventureWorksLTConnectionString 的连接字符串的 ASP.NET 网站或 Web 应用程序。 有关如何设置与 AdventureWorksLT 数据库的连接的信息，请参阅 How to： Set Up an AdventureWorksLT Sample Database for ASP.NET Development。

有关 ASP.NET 路由的详细信息，请参阅 ASP.NET 路由。

注解

如果在网站中实现 ASP.NET 路由，则可以使用 RouteParameter 对象将请求的 URL 段的值绑定到数据库查询或命令。 可以在数据源控件或 控件的QueryExtender标记中声明RouteParameter对象。

本主题随附了一个带有源代码的 Visual Studio 网站项目： 下载。

构造函数

RouteParameter()	初始化 RouteParameter 类的新实例。
RouteParameter(RouteParameter)	通过使用指定实例的值，初始化 RouteParameter 类的新实例。
RouteParameter(String, DbType, String)	通过使用参数的指定名称和数据库类型以及使用路由数据的指定键，初始化 RouteParameter 类的新实例。
RouteParameter(String, String)	通过使用参数的指定名称以及路由数据的指定键，初始化 RouteParameter 类的新实例。
RouteParameter(String, TypeCode, String)	通过使用参数的指定名称和类型以及使用路由数据的指定键，初始化 RouteParameter 类的新实例。

属性

ConvertEmptyStringToNull	获取或设置一个值，该值指示在 Parameter 对象绑定到的值为 Empty 时是否应将其转换为 null。 (继承自 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 Web 服务器控件概述