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

継承

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 アプリケーションでのルーティングの処理方法を指定できます。 そのパターンに対応する要求を処理できるクラスにマップする URL パターンごとに、 Route オブジェクトを作成します。 次に、 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が割り当てられます。 セグメントが中かっこで囲まれていない場合、値はリテラル値として扱われます。

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

こちらもご覧ください

• ASP.NET ルーティング