Route クラス

リファレンス

定義

名前空間:: System.Web.Routing

アセンブリ:: System.Web.Routing.dll

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

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 ルーティング

Share via