HttpResponse.RedirectToRoutePermanent Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Provede trvalé přesměrování z požadované adresy URL na novou adresu URL pomocí hodnot parametrů trasy, názvu trasy nebo obojího.

Přetížení

RedirectToRoutePermanent(String, Object)	Provede trvalé přesměrování z požadované adresy URL na novou adresu URL pomocí hodnot parametrů trasy a názvu trasy, které odpovídají nové adrese URL.
RedirectToRoutePermanent(Object)	Provede trvalé přesměrování z požadované adresy URL na novou adresu URL pomocí hodnot parametrů trasy.
RedirectToRoutePermanent(String)	Provede trvalé přesměrování z požadované adresy URL na novou adresu URL pomocí názvu trasy.
RedirectToRoutePermanent(RouteValueDictionary)	Provede trvalé přesměrování z požadované adresy URL na novou adresu URL pomocí hodnot parametrů trasy.
RedirectToRoutePermanent(String, RouteValueDictionary)	Provede trvalé přesměrování z požadované adresy URL na novou adresu URL pomocí hodnot parametrů trasy a názvu trasy.

RedirectToRoutePermanent(String, Object)

Provede trvalé přesměrování z požadované adresy URL na novou adresu URL pomocí hodnot parametrů trasy a názvu trasy, které odpovídají nové adrese URL.

public:
 void RedirectToRoutePermanent(System::String ^ routeName, System::Object ^ routeValues);

public void RedirectToRoutePermanent (string routeName, object routeValues);

member this.RedirectToRoutePermanent : string * obj -> unit

Public Sub RedirectToRoutePermanent (routeName As String, routeValues As Object)

Parametry

routeName

String

Název trasy.

routeValues

Object

Hodnoty parametrů trasy.

Výjimky

InvalidOperationException

Žádná trasa neodpovídá zadaným parametrům trasy.

HttpException

Po odeslání hlaviček HTTP došlo k pokusu o přesměrování.

Příklady

Následující příklad ukazuje, jak volat tuto metodu pro přesměrování na trasu s názvem Product a s parametry s názvem productid a category.

Response.RedirectToRoutePermanent("Product",
  New With {.productid = "1", .category = "widgets"})

Response.RedirectToRoutePermanent("Product",
  new { productid = "1", category = "widgets" });

Poznámky

Tato metoda je k dispozici pro usnadnění kódování. Je to ekvivalent volání RedirectPermanent metody s druhým parametrem nastaveným na false.

Tato metoda převede objekt, který je předán routeValues do objektu System.Web.Routing.RouteValueDictionary pomocí konstruktoru RouteValueDictionary.RouteValueDictionary(Object) . Pak je RouteCollection.GetVirtualPath volána metoda k určení adresy URL.

ASP.NET provede přesměrování vrácením stavového kódu HTTP 301.

Viz také

• směrování ASP.NET

RedirectToRoutePermanent(Object)

Provede trvalé přesměrování z požadované adresy URL na novou adresu URL pomocí hodnot parametrů trasy.

public:
 void RedirectToRoutePermanent(System::Object ^ routeValues);

public void RedirectToRoutePermanent (object routeValues);

member this.RedirectToRoutePermanent : obj -> unit

Public Sub RedirectToRoutePermanent (routeValues As Object)

Parametry

routeValues

Object

Hodnoty parametrů trasy.

Výjimky

InvalidOperationException

Žádná trasa neodpovídá zadaným parametrům trasy.

HttpException

Po odeslání hlaviček HTTP došlo k pokusu o přesměrování.

Příklady

Následující příklad ukazuje, jak volat tuto metodu pro přesměrování na trasu, která má parametry s názvem productid a category.

Response.RedirectToRoutePermanent(
  New With {.productid = "1", .category = "widgets"})

Response.RedirectToRoutePermanent(
  new { productid = "1", category = "widgets" });

Poznámky

Tato metoda je k dispozici pro usnadnění kódování. Je to ekvivalent volání RedirectPermanent(String, Boolean) metody s druhým parametrem nastaveným na false.

Tato metoda převede objekt, který je předán routeValues do objektu System.Web.Routing.RouteValueDictionary pomocí konstruktoru RouteValueDictionary.RouteValueDictionary(Object) . Pak je RouteCollection.GetVirtualPath volána metoda k určení adresy URL.

ASP.NET provede přesměrování vrácením stavového kódu HTTP 301.

Viz také

• směrování ASP.NET

RedirectToRoutePermanent(String)

Provede trvalé přesměrování z požadované adresy URL na novou adresu URL pomocí názvu trasy.

public:
 void RedirectToRoutePermanent(System::String ^ routeName);

public void RedirectToRoutePermanent (string routeName);

member this.RedirectToRoutePermanent : string -> unit

Public Sub RedirectToRoutePermanent (routeName As String)

Parametry

routeName

String

Název trasy.

Výjimky

InvalidOperationException

Žádná trasa neodpovídá zadaným parametrům trasy.

HttpException

Po odeslání hlaviček HTTP došlo k pokusu o přesměrování.

Příklady

Následující příklad ukazuje, jak volat tuto metodu pro přesměrování na trasu s názvem Products.

Response.RedirectToRoutePermanent("Products")

Response.RedirectToRoutePermanent("Products");

Poznámky

Tato metoda je k dispozici pro usnadnění kódování. Je to ekvivalent volání RedirectPermanent(String, Boolean) metody s druhým parametrem nastaveným na false.

Tato metoda převede název trasy, který je předán routeName do adresy URL pomocí RouteCollection.GetVirtualPath metody .

ASP.NET provede přesměrování vrácením stavového kódu HTTP 301.

Viz také

• směrování ASP.NET

RedirectToRoutePermanent(RouteValueDictionary)

Provede trvalé přesměrování z požadované adresy URL na novou adresu URL pomocí hodnot parametrů trasy.

public:
 void RedirectToRoutePermanent(System::Web::Routing::RouteValueDictionary ^ routeValues);

public void RedirectToRoutePermanent (System.Web.Routing.RouteValueDictionary routeValues);

member this.RedirectToRoutePermanent : System.Web.Routing.RouteValueDictionary -> unit

Public Sub RedirectToRoutePermanent (routeValues As RouteValueDictionary)

Parametry

routeValues

RouteValueDictionary

Hodnoty parametrů trasy.

Výjimky

InvalidOperationException

Žádná trasa neodpovídá zadaným parametrům trasy.

HttpException

Po odeslání hlaviček HTTP došlo k pokusu o přesměrování.

Příklady

Následující příklad ukazuje, jak volat tuto metodu pro přesměrování na trasu, která má parametry s názvem productid a category.

Response.RedirectToRoutePermanent(
  new RouteValueDictionary {productId="1", category="widgets"})

Response.RedirectToRoutePermanent(
  new RouteValueDictionary {productId="1", category="widgets"});

Poznámky

Tato metoda je k dispozici pro usnadnění kódování. Je to ekvivalent volání Redirect(String, Boolean) metody s druhým parametrem nastaveným na false.

Tato metoda volá metodu RouteCollection.GetVirtualPath k určení adresy URL.

ASP.NET provede přesměrování vrácením stavového kódu HTTP 301.

Viz také

• směrování ASP.NET

RedirectToRoutePermanent(String, RouteValueDictionary)

Provede trvalé přesměrování z požadované adresy URL na novou adresu URL pomocí hodnot parametrů trasy a názvu trasy.

public:
 void RedirectToRoutePermanent(System::String ^ routeName, System::Web::Routing::RouteValueDictionary ^ routeValues);

public void RedirectToRoutePermanent (string routeName, System.Web.Routing.RouteValueDictionary routeValues);

member this.RedirectToRoutePermanent : string * System.Web.Routing.RouteValueDictionary -> unit

Public Sub RedirectToRoutePermanent (routeName As String, routeValues As RouteValueDictionary)

Parametry

routeName

String

Název trasy.

routeValues

RouteValueDictionary

Hodnoty parametrů trasy.

Výjimky

InvalidOperationException

Žádná trasa neodpovídá zadaným parametrům trasy.

HttpException

Po odeslání hlaviček HTTP došlo k pokusu o přesměrování.

Příklady

Následující příklad ukazuje, jak volat tuto metodu pro přesměrování na trasu s názvem Product a s parametry s názvem productid a category.

Response.RedirectToRoutePermanent("Product",
  new RouteValueDictionary {productId="1", category="widgets"})

Response.RedirectToRoutePermanent("Product",
  new RouteValueDictionary {productId="1", category="widgets"});

Poznámky

Tato metoda je k dispozici pro usnadnění kódování. Je to ekvivalent volání Redirect(String, Boolean) metody s druhým parametrem nastaveným na false.

Tato metoda volá metodu RouteCollection.GetVirtualPath k určení adresy URL.

ASP.NET provede přesměrování vrácením stavového kódu HTTP 301.

Viz také

• směrování ASP.NET