言語

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 ルーティングでは、値に一致するコレクション内の最初のルートが使用されます。 詳細については、「 方法: ルートから URL を構築する」を参照してください。

名前は、 RouteCollection オブジェクトで 1 回だけ使用できます。

ルートの名前を指定する必要がない場合は、 Add メソッドを呼び出してルートを追加できます。

GetReadLock メソッドと GetWriteLock メソッドを使用して、他のプロセスとの競合なしにコレクションを操作できるようにします。

適用対象

こちらもご覧ください