RouteCollection.Add(String, RouteBase) 方法

定义

命名空间:

System.Web.Routing

程序集:

System.Web.dll

向 RouteCollection 对象末尾添加路由，并为该路由分配指定的名称。

public:
 void Add(System::String ^ name, System::Web::Routing::RouteBase ^ item);

public void Add (string name, System.Web.Routing.RouteBase item);

override this.Add : string * System.Web.Routing.RouteBase -> unit

Public Sub Add (name As String, item As RouteBase)

参数

name

String

标识该路由的值。 该值可为 null 或空字符串。

item

RouteBase

要添加到集合末尾的路由。

例外

ArgumentNullException

item 为 null。

ArgumentException

name 已在集合中使用。

示例

以下示例演示如何向 对象添加路由 RouteCollection ，并为路由分配名称。

void Application_Start(object sender, EventArgs e) 
{
    RegisterRoutes(RouteTable.Routes);
}

Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
    RegisterRoutes(RouteTable.Routes)
End Sub

注解

使用 Add 方法，可以在将路由添加到路由集合时定义路由的名称。 通过定义路由的名称，可以指定在使用路由构造 URL 时要使用的特定路由。 当多个路由与传递给 GetVirtualPath 方法的值匹配时，指定特定路由非常重要。 如果未指定命名路由，ASP.NET 路由将使用集合中与值匹配的第一个路由。 有关详细信息，请参阅 如何：从路由构造 URL。

一个名称只能在 对象中使用 RouteCollection 一次。

如果不必指定路由的名称，可以通过调用 Add 方法添加路由。

GetReadLock使用 方法和 GetWriteLock 方法可确保与集合交互，而不会与其他进程发生冲突。

另请参阅

• ASP.NET 路由