語言

RouteCollection.Add(String, RouteBase) 方法

定義

命名空間:
System.Web.Routing
組件:
System.Web.Routing.dll
組件:
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 路由會使用集合中第一個與這些值相符的路由。 欲了解更多資訊，請參閱 「如何從路由建構網址」。

一個名稱在物件中 RouteCollection 只能使用一次。

如果你不需要指定路由名稱，可以透過呼叫 Add 方法來新增路徑。

善用這個 GetReadLock 方法和方法 GetWriteLock ，確保你與收藏互動時不會與其他流程產生衝突。

適用於

另請參閱