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 路由