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}세 개의 세그먼트가 있는 패턴은 URL http://www.contoso.com/products/show/beverages과 일치합니다. 각 세그먼트는 문자로 구분됩니다 / . 세그먼트가 중괄호({ 및 })로 묶이면 세그먼트를 URL 매개 변수라고 합니다. ASP.NET 라우팅은 요청에서 값을 검색하고 URL 매개 변수에 할당합니다. 이전 예제에서 URL 매개 변수 action 에는 값 show이 할당됩니다. 세그먼트가 중괄호로 묶이지 않으면 값은 리터럴 값으로 처리됩니다.

매개 변수가 Defaults URL에서 누락된 경우 또는 URL에서 매개 변수화되지 않은 추가 값을 설정하기 위해 사용되는 값을 포함하는 개체로 속성을 RouteValueDictionary 설정합니다. 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	ASP.NET 라우팅에서 기존 파일과 일치하는 URL을 처리할지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 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 라우팅