다음을 통해 공유


RouteCollection.MapPageRoute 메서드

정의

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입니다.

반환

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

예제

다음 예제에서는 이 메서드를 사용하여 경로를 정의하는 방법을 보여줍니다. 첫 번째 문은 이름이 없는 경로를 정의합니다. 두 번째 문은 명명된 경로를 정의합니다. 이 예제는 메서드 개요에서 사용할 수 있는 더 큰 예제의 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 전달하는 것과 같습니다.

추가 정보

적용 대상

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 속성을 설정합니다.

반환

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

예제

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

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

설명

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

추가 정보

적용 대상

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

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

defaults
RouteValueDictionary

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

반환

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

예제

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

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 전달하는 것과 같습니다.

추가 정보

적용 대상

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

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

defaults
RouteValueDictionary

경로의 기본값입니다.

constraints
RouteValueDictionary

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

반환

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

예제

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

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 전달하는 것과 같습니다.

추가 정보

적용 대상

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

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

defaults
RouteValueDictionary

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

constraints
RouteValueDictionary

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

dataTokens
RouteValueDictionary

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

반환

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

예외

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 전달하는 것과 같습니다.

추가 정보

적용 대상