RouteCollection.MapPageRoute 메서드

참조

정의

네임스페이스:: System.Web.Routing

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

Web Forms 애플리케이션의 경로를 정의하는 방법을 제공합니다.

오버로드

MapPageRoute(String, String, String)	Web Forms 애플리케이션의 경로를 정의하는 방법을 제공합니다.
MapPageRoute(String, String, String, Boolean)	Web Forms 애플리케이션의 경로를 정의하는 방법을 제공합니다.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	Web Forms 애플리케이션의 경로를 정의하는 방법을 제공합니다.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	Web Forms 애플리케이션의 경로를 정의하는 방법을 제공합니다.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	Web Forms 애플리케이션의 경로를 정의하는 방법을 제공합니다.

예제

다음 예제에서는이 메서드를 사용 하는 Web Forms 애플리케이션에 대 한 경로 정의 하는 방법을 보여 줍니다. 이 예제에서는 Global.asax 파일에서 Application_Start 호출되는 명명 RegisterRoutes 된 메서드를 보여줍니다. 메서드 오버 로드 각각 사용 하 여 MapPageRoute 애플리케이션에는 경로 추가 합니다. Web Forms 애플리케이션에 대 한 경로 정의 하는 방법에 대 한 자세한 내용은 참조 하세요. 방법: Web Forms 애플리케이션에 대 한 경로 정의합니다.

 void RegisterRoutes(RouteCollection routes)
{
    routes.MapPageRoute("",
        "SalesReport/{locale}/{year}/{*queryvalues}", "~/sales.aspx");

    routes.MapPageRoute("SalesSummaryRoute",
        "SalesReportSummary/{locale}", "~/sales.aspx");

    routes.MapPageRoute("SalesDetailRoute",
        "SalesReportDetail/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
        false);

    routes.MapPageRoute("SalesCurrentYearRoute",
        "SalesReportCurrent/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
        false,
        new RouteValueDictionary 
            { { "locale", "US" }, { "year", DateTime.Now.Year.ToString() } });

    routes.MapPageRoute("ExpenseCurrentYearRoute",
        "ExpenseReportCurrent/{locale}", "~/expenses.aspx",
        false,
        new RouteValueDictionary 
            { { "locale", "US" }, { "year", DateTime.Now.Year.ToString() } },
        new RouteValueDictionary 
            { { "locale", "[a-z]{2}" }, { "year", @"\d{4}" } });

    routes.MapPageRoute("ExpenseDetailRoute",
        "ExpenseReportDetail/{locale}/{year}/{*queryvalues}", "~/expenses.aspx",
        false,
        new RouteValueDictionary 
            { { "locale", "US" }, { "year", DateTime.Now.Year.ToString() } },
        new RouteValueDictionary 
            { { "locale", "[a-z]{2}" }, { "year", @"\d{4}" } },
        new RouteValueDictionary 
            { { "account", "1234" }, { "subaccount", "5678" } });
}

Sub RegisterRoutes(ByVal routes As RouteCollection)
    routes.MapPageRoute("",
        "SalesReport/{locale}/{year}/{*queryvalues}", "~/sales.aspx")

    routes.MapPageRoute("SalesSummaryRoute",
        "SalesReportSummary/{locale}", "~/sales.aspx")

    routes.MapPageRoute("SalesDetailRoute",
        "SalesReportDetail/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
        False)

    routes.MapPageRoute("SalesCurrentYearRoute",
        "SalesReportCurrent/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
        false,
        new RouteValueDictionary(New With _ 
            { .locale = "US", .year = DateTime.Now.Year.ToString()}))

    routes.MapPageRoute("ExpenseCurrentYearRoute",
        "ExpenseReportCurrent/{locale}", "~/expenses.aspx",
        false,
        new RouteValueDictionary(New With _
            { .locale = "US", .year = DateTime.Now.Year.ToString()}),
        new RouteValueDictionary(New With _
            { .locale = "[a-z]{2}", .year = "\d{4}" }))

    routes.MapPageRoute("ExpenseDetailRoute",
        "ExpenseReportDetail/{locale}/{year}/{*queryvalues}", "~/expenses.aspx",
        false,
        new RouteValueDictionary(New With _
            { .locale = "US", .year = DateTime.Now.Year.ToString()}),
        new RouteValueDictionary(New With _ 
            { .locale = "[a-z]{2}", .year = "\d{4}" }),
        new RouteValueDictionary(New With _
            { .account = "1234", .subaccount = "5678" }))
End Sub

설명

이 메서드는 코딩 편의를 위해 제공됩니다. 메서드를 호출하고 클래스를 Add 사용하여 PageRouteHandler 만든 개체를 Route 전달하는 것과 같습니다.

MapPageRoute(String, String, String)

Web Forms 애플리케이션의 경로를 정의하는 방법을 제공합니다.

public:
 System::Web::Routing::Route ^ MapPageRoute(System::String ^ routeName, System::String ^ routeUrl, System::String ^ physicalFile);

public System.Web.Routing.Route MapPageRoute (string routeName, string routeUrl, string physicalFile);

member this.MapPageRoute : string * string * string -> System.Web.Routing.Route

Public Function MapPageRoute (routeName As String, routeUrl As String, physicalFile As String) As Route

매개 변수

routeName: String

경로의 이름입니다.

routeUrl: String

경로의 URL 패턴입니다.

physicalFile: String

경로의 실제 URL입니다.

반환

Route

경로 컬렉션에 추가되는 경로입니다.

예제

다음 예제에서는이 메서드를 사용 하 여 경로를 정의 하는 방법을 보여 있습니다. 첫 번째 문은 이름이 없는 경로를 정의합니다. 두 번째 문은 명명된 경로를 정의합니다. 이 예제는 메서드 개요에서 사용할 수 있는 더 큰 예제의 MapPageRoute 일부입니다.

routes.MapPageRoute("",
    "SalesReport/{locale}/{year}/{*queryvalues}", "~/sales.aspx");

routes.MapPageRoute("SalesSummaryRoute",
    "SalesReportSummary/{locale}", "~/sales.aspx");

routes.MapPageRoute("",
    "SalesReport/{locale}/{year}/{*queryvalues}", "~/sales.aspx")

routes.MapPageRoute("SalesSummaryRoute",
    "SalesReportSummary/{locale}", "~/sales.aspx")

설명

이 메서드는 코딩 편의를 위해 제공됩니다. 메서드를 호출하고 클래스를 Add 사용하여 PageRouteHandler 만든 개체를 Route 전달하는 것과 같습니다.

추가 정보

ASP.NET 라우팅

적용 대상

MapPageRoute(String, String, String, Boolean)

Web Forms 애플리케이션의 경로를 정의하는 방법을 제공합니다.

public:
 System::Web::Routing::Route ^ MapPageRoute(System::String ^ routeName, System::String ^ routeUrl, System::String ^ physicalFile, bool checkPhysicalUrlAccess);

public System.Web.Routing.Route MapPageRoute (string routeName, string routeUrl, string physicalFile, bool checkPhysicalUrlAccess);

member this.MapPageRoute : string * string * string * bool -> System.Web.Routing.Route

Public Function MapPageRoute (routeName As String, routeUrl As String, physicalFile As String, checkPhysicalUrlAccess As Boolean) As Route

매개 변수

routeName: String

경로의 이름입니다.

routeUrl: String

경로의 URL 패턴입니다.

physicalFile: String

경로의 실제 URL입니다.

checkPhysicalUrlAccess: Boolean

ASP.NET에서 사용자가 실제 URL에 액세스할 수 있는 권한을 가지고 있는지를 확인해야 할지(경로 URL이 항상 검사되는지) 여부를 나타내는 값입니다. 이 매개 변수는 CheckPhysicalUrlAccess 속성을 설정합니다.

반환

Route

경로 컬렉션에 추가되는 경로입니다.

예제

다음 예제에서는이 메서드를 사용 하 여 경로를 정의 하는 방법을 보여 있습니다. 이 예제는 메서드 개요에서 사용할 수 있는 더 큰 예제의 MapPageRoute 일부입니다.

routes.MapPageRoute("SalesDetailRoute",
    "SalesReportDetail/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
    false);

routes.MapPageRoute("SalesDetailRoute",
    "SalesReportDetail/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
    False)

설명

이 메서드는 코딩 편의를 위해 제공됩니다. 메서드를 호출하고 클래스를 Add 사용하여 PageRouteHandler 만든 개체를 Route 전달하는 것과 같습니다.

추가 정보

ASP.NET 라우팅

적용 대상

MapPageRoute(String, String, String, Boolean, RouteValueDictionary)

Web Forms 애플리케이션의 경로를 정의하는 방법을 제공합니다.

public:
 System::Web::Routing::Route ^ MapPageRoute(System::String ^ routeName, System::String ^ routeUrl, System::String ^ physicalFile, bool checkPhysicalUrlAccess, System::Web::Routing::RouteValueDictionary ^ defaults);

public System.Web.Routing.Route MapPageRoute (string routeName, string routeUrl, string physicalFile, bool checkPhysicalUrlAccess, System.Web.Routing.RouteValueDictionary defaults);

member this.MapPageRoute : string * string * string * bool * System.Web.Routing.RouteValueDictionary -> System.Web.Routing.Route

Public Function MapPageRoute (routeName As String, routeUrl As String, physicalFile As String, checkPhysicalUrlAccess As Boolean, defaults As RouteValueDictionary) As Route

매개 변수

routeName: String

경로의 이름입니다.

routeUrl: String

경로의 URL 패턴입니다.

physicalFile: String

경로의 실제 URL입니다.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

경로 매개 변수의 기본값입니다.

반환

Route

경로 컬렉션에 추가되는 경로입니다.

예제

routes.MapPageRoute("SalesCurrentYearRoute",
    "SalesReportCurrent/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
    false,
    new RouteValueDictionary 
        { { "locale", "US" }, { "year", DateTime.Now.Year.ToString() } });

routes.MapPageRoute("SalesCurrentYearRoute",
    "SalesReportCurrent/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
    false,
    new RouteValueDictionary(New With _ 
        { .locale = "US", .year = DateTime.Now.Year.ToString()}))

설명

이 메서드는 코딩 편의를 위해 제공됩니다. 메서드를 호출하고 클래스를 Add 사용하여 PageRouteHandler 만든 개체를 Route 전달하는 것과 같습니다.

추가 정보

ASP.NET 라우팅

적용 대상

MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)

Web Forms 애플리케이션의 경로를 정의하는 방법을 제공합니다.

public:
 System::Web::Routing::Route ^ MapPageRoute(System::String ^ routeName, System::String ^ routeUrl, System::String ^ physicalFile, bool checkPhysicalUrlAccess, System::Web::Routing::RouteValueDictionary ^ defaults, System::Web::Routing::RouteValueDictionary ^ constraints);

public System.Web.Routing.Route MapPageRoute (string routeName, string routeUrl, string physicalFile, bool checkPhysicalUrlAccess, System.Web.Routing.RouteValueDictionary defaults, System.Web.Routing.RouteValueDictionary constraints);

member this.MapPageRoute : string * string * string * bool * System.Web.Routing.RouteValueDictionary * System.Web.Routing.RouteValueDictionary -> System.Web.Routing.Route

Public Function MapPageRoute (routeName As String, routeUrl As String, physicalFile As String, checkPhysicalUrlAccess As Boolean, defaults As RouteValueDictionary, constraints As RouteValueDictionary) As Route

매개 변수

routeName: String

경로의 이름입니다.

routeUrl: String

경로의 URL 패턴입니다.

physicalFile: String

경로의 실제 URL입니다.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

경로의 기본값입니다.

constraints: RouteValueDictionary

URL 요청이 이 경로로 처리되기 위해 충족해야 할 제약 조건입니다.

반환

Route

경로 컬렉션에 추가되는 경로입니다.

예제

routes.MapPageRoute("ExpenseCurrentYearRoute",
    "ExpenseReportCurrent/{locale}", "~/expenses.aspx",
    false,
    new RouteValueDictionary 
        { { "locale", "US" }, { "year", DateTime.Now.Year.ToString() } },
    new RouteValueDictionary 
        { { "locale", "[a-z]{2}" }, { "year", @"\d{4}" } });

routes.MapPageRoute("ExpenseCurrentYearRoute",
    "ExpenseReportCurrent/{locale}", "~/expenses.aspx",
    false,
    new RouteValueDictionary(New With _
        { .locale = "US", .year = DateTime.Now.Year.ToString()}),
    new RouteValueDictionary(New With _
        { .locale = "[a-z]{2}", .year = "\d{4}" }))

설명

이 메서드는 코딩 편의를 위해 제공됩니다. 메서드를 호출하고 클래스를 Add 사용하여 PageRouteHandler 만든 개체를 Route 전달하는 것과 같습니다.

추가 정보

ASP.NET 라우팅

적용 대상

MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)

Web Forms 애플리케이션의 경로를 정의하는 방법을 제공합니다.

public:
 System::Web::Routing::Route ^ MapPageRoute(System::String ^ routeName, System::String ^ routeUrl, System::String ^ physicalFile, bool checkPhysicalUrlAccess, System::Web::Routing::RouteValueDictionary ^ defaults, System::Web::Routing::RouteValueDictionary ^ constraints, System::Web::Routing::RouteValueDictionary ^ dataTokens);

public System.Web.Routing.Route MapPageRoute (string routeName, string routeUrl, string physicalFile, bool checkPhysicalUrlAccess, System.Web.Routing.RouteValueDictionary defaults, System.Web.Routing.RouteValueDictionary constraints, System.Web.Routing.RouteValueDictionary dataTokens);

member this.MapPageRoute : string * string * string * bool * System.Web.Routing.RouteValueDictionary * System.Web.Routing.RouteValueDictionary * System.Web.Routing.RouteValueDictionary -> System.Web.Routing.Route

Public Function MapPageRoute (routeName As String, routeUrl As String, physicalFile As String, checkPhysicalUrlAccess As Boolean, defaults As RouteValueDictionary, constraints As RouteValueDictionary, dataTokens As RouteValueDictionary) As Route

매개 변수

routeName: String

경로의 이름입니다.

routeUrl: String

경로의 URL 패턴입니다.

physicalFile: String

경로의 실제 URL입니다.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

경로 매개 변수의 기본값입니다.

constraints: RouteValueDictionary

URL 요청이 이 경로로 처리되기 위해 충족해야 할 제약 조건입니다.

dataTokens: RouteValueDictionary

경로와 연결되지만 경로가 URL 패턴과 일치하는지 여부를 결정하는 데 사용되지 않는 값입니다.

반환

Route

경로 컬렉션에 추가되는 경로입니다.

예외

ArgumentNullException

routeUrl 매개 변수가 null인 경우

예제

다음 예제에서는 이 메서드를 사용하여 경로를 정의하는 방법을 보여줍니다. 이 예제는 메서드 개요에서 사용할 수 있는 더 큰 예제의 MapPageRoute 일부입니다.

routes.MapPageRoute("ExpenseDetailRoute",
    "ExpenseReportDetail/{locale}/{year}/{*queryvalues}", "~/expenses.aspx",
    false,
    new RouteValueDictionary 
        { { "locale", "US" }, { "year", DateTime.Now.Year.ToString() } },
    new RouteValueDictionary 
        { { "locale", "[a-z]{2}" }, { "year", @"\d{4}" } },
    new RouteValueDictionary 
        { { "account", "1234" }, { "subaccount", "5678" } });

routes.MapPageRoute("ExpenseDetailRoute",
    "ExpenseReportDetail/{locale}/{year}/{*queryvalues}", "~/expenses.aspx",
    false,
    new RouteValueDictionary(New With _
        { .locale = "US", .year = DateTime.Now.Year.ToString()}),
    new RouteValueDictionary(New With _ 
        { .locale = "[a-z]{2}", .year = "\d{4}" }),
    new RouteValueDictionary(New With _
        { .account = "1234", .subaccount = "5678" }))

설명

이 메서드는 코딩 편의를 위해 제공됩니다. 메서드를 호출하고 클래스를 Add 사용하여 PageRouteHandler 만든 개체를 Route 전달하는 것과 같습니다.

추가 정보

ASP.NET 라우팅

적용 대상

RouteCollection.MapPageRoute 메서드

정의

오버로드

예제

설명

MapPageRoute(String, String, String)

매개 변수

반환

예제

설명

추가 정보

적용 대상

MapPageRoute(String, String, String, Boolean)

매개 변수

반환

예제

설명

추가 정보

적용 대상

MapPageRoute(String, String, String, Boolean, RouteValueDictionary)

매개 변수

반환

예제

설명

추가 정보

적용 대상

MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)

매개 변수

반환

예제

설명

추가 정보

적용 대상

MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)

매개 변수

반환

예외

예제

설명

추가 정보

적용 대상

추가 리소스