Route クラス

定義

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

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
継承
派生

次の例は、オブジェクトを作成 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 でパラメーター化されていない追加の値を設定します。 プロパティを ConstraintsRouteValueDictionary 正規表現または 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)

適用対象

こちらもご覧ください