Share via


RouteCollection.Add(String, RouteBase) メソッド

定義

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

コレクションの末尾に追加するルート。

例外

itemnullです。

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プロセスとの競合なしにコレクションと対話することを確認します。

適用対象

こちらもご覧ください