RouteParameter 类

定义

将 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
继承
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 链接不包含路由参数。 因此,查询参数的 对象@cultureRouteParameter定义的默认值“en”将在查询中使用。 第二个 culture 链接提供值“fr”,这会导致说明以法语显示。 有关如何使用 RouteUrl 表达式的详细信息,请参阅 如何:从路由构造 URL

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

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

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

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

若要运行此示例,请将两个.aspx页和 Global.asax 文件中的代码添加到定义 AdventureWorksLT 数据库连接字符串 AdventureWorksLTConnectionString 的 ASP.NET 网站或 Web 应用程序。 有关如何设置与 AdventureWorksLT 数据库的连接的信息,请参阅 如何:设置 AdventureWorksLT 示例数据库以用于 ASP.NET 开发

有关 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)

适用于

另请参阅