RouteCollection.MapPageRoute Yöntem

Başvuru

Tanım

Ad Alanı:: System.Web.Routing

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Web Forms uygulamaları için yolları tanımlamanın bir yolunu sağlar.

Aşırı Yüklemeler

MapPageRoute(String, String, String)	Web Forms uygulamaları için yolları tanımlamanın bir yolunu sağlar.
MapPageRoute(String, String, String, Boolean)	Web Forms uygulamaları için yolları tanımlamanın bir yolunu sağlar.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	Web Forms uygulamaları için yolları tanımlamanın bir yolunu sağlar.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	Web Forms uygulamaları için yolları tanımlamanın bir yolunu sağlar.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	Web Forms uygulamaları için yolları tanımlamanın bir yolunu sağlar.

Örnekler

Aşağıdaki örnekte, bu yöntemi kullanarak bir Web Forms uygulaması için yolların nasıl tanımlanacağı gösterilmektedir. Örnekte, Global.asax dosyasından Application_Start çağrılan adlı RegisterRoutes bir yöntem gösterilmektedir. yöntemi, uygulamasına bir yol eklemek için öğesinin her aşırı yüklemesini MapPageRoute kullanır. Web Forms uygulamaları için yolları tanımlama hakkında daha fazla bilgi için bkz . Nasıl yapılır: Web Forms Uygulamaları için Yolları Tanımlama.

 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

Açıklamalar

Bu yöntem, kodlama kolaylığı için sağlanır. yöntemini çağırmak Add ve sınıfı kullanılarak oluşturulan bir Route nesneyi geçirmekle PageRouteHandler eşdeğerdir.

MapPageRoute(String, String, String)

Web Forms uygulamaları için yolları tanımlamanın bir yolunu sağlar.

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

Parametreler

routeName: String

Yolun adı.

routeUrl: String

Yol için URL deseni.

physicalFile: String

Yolun fiziksel URL'si.

Döndürülenler

Route

Yol koleksiyonuna eklenen yol.

Örnekler

Aşağıdaki örnekte, bu yöntemi kullanarak bir yolun nasıl tanımlanacağı gösterilmektedir. İlk deyim, adı olmayan bir yol tanımlar. İkinci deyim adlandırılmış bir yol tanımlar. Bu örnek, yönteme genel bakış bölümünde MapPageRoute bulunan daha büyük bir örneğin parçasıdır.

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")

Açıklamalar

Bu yöntem, kodlama kolaylığı için sağlanır. yöntemini çağırmak Add ve sınıfı kullanılarak oluşturulan bir Route nesneyi geçirmekle PageRouteHandler eşdeğerdir.

Ayrıca bkz.

ASP.NET Yönlendirme

Şunlara uygulanır

MapPageRoute(String, String, String, Boolean)

Web Forms uygulamaları için yolları tanımlamanın bir yolunu sağlar.

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

Parametreler

routeName: String

Yolun adı.

routeUrl: String

Yol için URL deseni.

physicalFile: String

Yolun fiziksel URL'si.

checkPhysicalUrlAccess: Boolean

ASP.NET kullanıcının fiziksel URL'ye erişim yetkisine sahip olduğunu doğrulaması gerekip gerekmediğini belirten bir değerdir (yol URL'si her zaman denetlenmektedir). Bu parametre özelliğini ayarlar CheckPhysicalUrlAccess .

Döndürülenler

Route

Yol koleksiyonuna eklenen yol.

Örnekler

Aşağıdaki örnekte, bu yöntemi kullanarak bir yolun nasıl tanımlanacağı gösterilmektedir. Bu örnek, yönteme genel bakış bölümünde MapPageRoute bulunan daha büyük bir örneğin parçasıdır.

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

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

Açıklamalar

Bu yöntem, kodlama kolaylığı için sağlanır. yöntemini çağırmak Add ve sınıfı kullanılarak oluşturulan bir Route nesneyi geçirmekle PageRouteHandler eşdeğerdir.

Ayrıca bkz.

ASP.NET Yönlendirme

Şunlara uygulanır

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

Web Forms uygulamaları için yolları tanımlamanın bir yolunu sağlar.

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

Parametreler

routeName: String

Yolun adı.

routeUrl: String

Yol için URL deseni.

physicalFile: String

Yolun fiziksel URL'si.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Yol parametreleri için varsayılan değerler.

Döndürülenler

Route

Yol koleksiyonuna eklenen yol.

Örnekler

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()}))

Açıklamalar

Bu yöntem, kodlama kolaylığı için sağlanır. yöntemini çağırmak Add ve sınıfı kullanılarak oluşturulan bir Route nesneyi geçirmekle PageRouteHandler eşdeğerdir.

Ayrıca bkz.

ASP.NET Yönlendirme

Şunlara uygulanır

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

Web Forms uygulamaları için yolları tanımlamanın bir yolunu sağlar.

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

Parametreler

routeName: String

Yolun adı.

routeUrl: String

Yol için URL deseni.

physicalFile: String

Yolun fiziksel URL'si.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Yol için varsayılan değerler.

constraints: RouteValueDictionary

Url isteğinin bu yol olarak işlenebilmesi için karşılaması gereken kısıtlamalar.

Döndürülenler

Route

Yol koleksiyonuna eklenen yol.

Örnekler

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}" }))

Açıklamalar

Bu yöntem, kodlama kolaylığı için sağlanır. yöntemini çağırmak Add ve sınıfı kullanılarak oluşturulan bir Route nesneyi geçirmekle PageRouteHandler eşdeğerdir.

Ayrıca bkz.

ASP.NET Yönlendirme

Şunlara uygulanır

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

Web Forms uygulamaları için yolları tanımlamanın bir yolunu sağlar.

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

Parametreler

routeName: String

Yolun adı.

routeUrl: String

Yol için URL deseni.

physicalFile: String

Yolun fiziksel URL'si.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Yol parametreleri için varsayılan değerler.

constraints: RouteValueDictionary

Url isteğinin bu yol olarak işlenebilmesi için karşılaması gereken kısıtlamalar.

dataTokens: RouteValueDictionary

Bir yolun url deseniyle eşleşip eşleşmediğini belirlemek için kullanılmayan yol ile ilişkili değerler.

Döndürülenler

Route

Yol koleksiyonuna eklenen yol.

Özel durumlar

ArgumentNullException

routeUrl parametresidirnull.

Örnekler

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" }))

Açıklamalar

Bu yöntem, kodlama kolaylığı için sağlanır. yöntemini çağırmak Add ve sınıfı kullanılarak oluşturulan bir Route nesneyi geçirmekle PageRouteHandler eşdeğerdir.

Ayrıca bkz.

ASP.NET Yönlendirme

Şunlara uygulanır

Aracılığıyla paylaş

RouteCollection.MapPageRoute Yöntem

Tanım

Aşırı Yüklemeler

Örnekler

Açıklamalar

MapPageRoute(String, String, String)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

MapPageRoute(String, String, String, Boolean)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

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

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

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

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

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

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar