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 1 回だけ使用できます。

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

メソッドと メソッドを GetReadLock 使用して、他の GetWriteLock プロセスとの競合なしでコレクションと対話することを確認します。

こちらもご覧ください

• ASP.NET ルーティング