Route クラス

定義

名前空間:

System.Web.Routing

アセンブリ:

System.Web.dll

ルートに関する情報を取得するためのルートを定義するプロパティとメソッドを提供します。

public ref class Route : System::Web::Routing::RouteBase

public class Route : System.Web.Routing.RouteBase

type Route = class
    inherit RouteBase

Public Class Route
Inherits RouteBase

継承

Object

RouteBase

Route

派生

System.ServiceModel.Activation.ServiceRoute

System.Web.DynamicData.DynamicDataRoute

例

次の例は、オブジェクトを作成 Route して プロパティに追加する方法を Routes 示しています。

void Application_Start(object sender, EventArgs e) 
{
    RegisterRoutes(RouteTable.Routes);
}

public static void RegisterRoutes(RouteCollection routes)
{
    routes.Add(new Route
    (
         "Category/{action}/{categoryName}"
         , new CategoryRouteHandler()
    ));
}

Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
    RegisterRoutes(RouteTable.Routes)
End Sub

Shared Sub RegisterRoutes(ByVal routes As RouteCollection)
    Dim urlPattern As String
    Dim categoryRoute As Route
    
    urlPattern = "Category/{action}/{categoryName}"
    
    categoryRoute = New Route(urlPattern, New CategoryRouteHandler)
    
    routes.Add(categoryRoute)
End Sub

注釈

Routeクラスを使用すると、ASP.NET アプリケーションでのルーティングの処理方法を指定できます。 そのパターンに対応する要求を Route 処理できるクラスにマップする URL パターンごとに オブジェクトを作成します。 次に、ルートをコレクションに Routes 追加します。 アプリケーションが要求を受信すると、ASP.NET ルーティングはコレクション内 Routes のルートを反復処理して、URL のパターンに一致する最初のルートを見つけます。

プロパティを Url URL パターンに設定します。 URL パターンは、HTTP 要求のアプリケーション名の後にあるセグメントで構成されます。 たとえば、URL http://www.contoso.com/products/show/beveragesでは、 パターンは に products/show/beverages適用されます。 などの {controller}/{action}/{id}3 つのセグメントを持つパターンは、URL http://www.contoso.com/products/show/beveragesと一致します。 各セグメントは、 文字で / 区切られます。 セグメントが中かっこ ({ および }) で囲まれている場合、セグメントは URL パラメーターと呼ばれます。 ルーティング ASP.NET 要求から値を取得し、URL パラメーターに割り当てます。 前の例では、URL パラメーター action に 値 showが割り当てられます。 セグメントが中かっこで囲まれていない場合、値はリテラル値として扱われます。

パラメーターが Defaults URL にない場合に RouteValueDictionary 使用される値を含むオブジェクトに プロパティを設定するか、URL でパラメーター化されていない追加の値を設定します。 プロパティを Constraints 、 RouteValueDictionary 正規表現または IRouteConstraint オブジェクトの値を含むオブジェクトに設定します。 これらの値は、パラメーター値が有効かどうかを判断するために使用されます。

コンストラクター

Route(String, IRouteHandler)	指定された URL パターンとハンドラー クラスを使用して、Route クラスの新しいインスタンスを初期化します。
Route(String, RouteValueDictionary, IRouteHandler)	指定した URL パターン、既定パラメーター値、およびハンドラー クラスを使用して、Route クラスの新しいインスタンスを初期化します。
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	指定した URL パターン、既定パラメーター値、制約、およびハンドラー クラスを使用して、Route クラスの新しいインスタンスを初期化します。
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	指定した URL パターン、既定パラメーター値、制約、カスタム値、およびハンドラー クラスを使用して、Route クラスの新しいインスタンスを初期化します。

プロパティ

Constraints	URL パラメーターの有効な値を指定する式のディクショナリを取得または設定します。
DataTokens	ルート ハンドラーに渡されるが、ルートが URL パターンに一致するかどうかの判定には使用されないカスタム値を取得または設定します。
Defaults	URL にすべてのパラメーターが含まれていない場合に使用する値を取得または設定します。
RouteExistingFiles	既存のファイルと一致する URL を ASP.NET ルーティングが処理するかどうかを示す値を取得または設定します。 (継承元 RouteBase)
RouteHandler	ルートの要求を処理するオブジェクトを取得または設定します。
Url	ルートの URL パターンを取得または設定します。

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetRouteData(HttpContextBase)	要求されたルートに関する情報を返します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetVirtualPath(RequestContext, RouteValueDictionary)	ルートと関連付けられている URL に関する情報を返します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)	パラメーター値がそのパラメーターの制約と一致するかどうかを判別します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

• ASP.NET ルーティング