RouteCollection.MapPageRoute 메서드

정의

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

어셈블리:: System.Web.dll

중요

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

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

오버로드

Name	Description
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 파일에서 RegisterRoutes 호출되는 명명 Application_Start 된 메서드를 보여줍니다. 메서드는 각 오버로드 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 사용하여 Route 만든 개체를 PageRouteHandler 전달하는 것과 같습니다.

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 사용하여 Route 만든 개체를 PageRouteHandler 전달하는 것과 같습니다.

추가 정보

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 사용하여 Route 만든 개체를 PageRouteHandler 전달하는 것과 같습니다.

추가 정보

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 사용하여 Route 만든 개체를 PageRouteHandler 전달하는 것과 같습니다.

추가 정보

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 사용하여 Route 만든 개체를 PageRouteHandler 전달하는 것과 같습니다.

추가 정보

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.

예제

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 사용하여 Route 만든 개체를 PageRouteHandler 전달하는 것과 같습니다.

추가 정보

ASP.NET 라우팅

적용 대상

피드백

이 페이지가 도움이 되었나요?