HttpResponse.RedirectToRoutePermanent Metoda

Definicja

Przestrzeń nazw:

System.Web

Zestaw:

System.Web.dll

Wykonuje trwałe przekierowanie z żądanego adresu URL do nowego adresu URL przy użyciu wartości parametrów trasy, nazwy trasy lub obu tych parametrów.

Przeciążenia

RedirectToRoutePermanent(String, Object)	Wykonuje trwałe przekierowanie z żądanego adresu URL do nowego adresu URL przy użyciu wartości parametrów trasy i nazwy trasy odpowiadającej nowemu adresowi URL.
RedirectToRoutePermanent(Object)	Wykonuje trwałe przekierowanie z żądanego adresu URL do nowego adresu URL przy użyciu wartości parametrów trasy.
RedirectToRoutePermanent(String)	Wykonuje trwałe przekierowanie z żądanego adresu URL do nowego adresu URL przy użyciu nazwy trasy.
RedirectToRoutePermanent(RouteValueDictionary)	Wykonuje trwałe przekierowanie z żądanego adresu URL do nowego adresu URL przy użyciu wartości parametrów trasy.
RedirectToRoutePermanent(String, RouteValueDictionary)	Wykonuje trwałe przekierowanie z żądanego adresu URL do nowego adresu URL przy użyciu wartości parametrów trasy i nazwy trasy.

RedirectToRoutePermanent(String, Object)

Wykonuje trwałe przekierowanie z żądanego adresu URL do nowego adresu URL przy użyciu wartości parametrów trasy i nazwy trasy odpowiadającej nowemu adresowi 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

Nazwa trasy.

routeValues

Object

Wartości parametrów trasy.

Wyjątki

InvalidOperationException

Żadna trasa nie odpowiada określonym parametrom trasy.

HttpException

Próba przekierowania została podjęta po wysłaniu nagłówków HTTP.

Przykłady

W poniższym przykładzie pokazano, jak wywołać tę metodę w celu przekierowania do trasy o nazwie i zawierającej parametry o nazwie Productproductid i category.

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

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

Uwagi

Ta metoda jest dostarczana do kodowania dla wygody. Jest to równoważne wywołaniu RedirectPermanent metody z drugim parametrem ustawionym na falsewartość .

Ta metoda konwertuje obiekt przekazywany routeValues do System.Web.Routing.RouteValueDictionary obiektu przy użyciu konstruktora RouteValueDictionary.RouteValueDictionary(Object) . Następnie wywoływana RouteCollection.GetVirtualPath jest metoda w celu określenia adresu URL.

ASP.NET wykonuje przekierowanie, zwracając kod stanu HTTP 301.

Zobacz też

• ASP.NET Routing

RedirectToRoutePermanent(Object)

Wykonuje trwałe przekierowanie z żądanego adresu URL do nowego adresu URL przy użyciu wartości parametrów 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

Wartości parametrów trasy.

Wyjątki

InvalidOperationException

Żadna trasa nie odpowiada określonym parametrom trasy.

HttpException

Próba przekierowania została podjęta po wysłaniu nagłówków HTTP.

Przykłady

W poniższym przykładzie pokazano, jak wywołać tę metodę w celu przekierowania do trasy zawierającej parametry o nazwach productid i category.

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

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

Uwagi

Ta metoda jest dostarczana do kodowania dla wygody. Jest to równoważne wywołaniu RedirectPermanent(String, Boolean) metody z drugim parametrem ustawionym na falsewartość .

Ta metoda konwertuje obiekt przekazywany routeValues do System.Web.Routing.RouteValueDictionary obiektu przy użyciu konstruktora RouteValueDictionary.RouteValueDictionary(Object) . Następnie wywoływana RouteCollection.GetVirtualPath jest metoda w celu określenia adresu URL.

ASP.NET wykonuje przekierowanie, zwracając kod stanu HTTP 301.

Zobacz też

• ASP.NET Routing

RedirectToRoutePermanent(String)

Wykonuje trwałe przekierowanie z żądanego adresu URL do nowego adresu URL przy użyciu nazwy 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

Nazwa trasy.

Wyjątki

InvalidOperationException

Żadna trasa nie odpowiada określonym parametrom trasy.

HttpException

Próba przekierowania została podjęta po wysłaniu nagłówków HTTP.

Przykłady

W poniższym przykładzie pokazano, jak wywołać tę metodę w celu przekierowania do trasy o nazwie Products.

Response.RedirectToRoutePermanent("Products")

Response.RedirectToRoutePermanent("Products");

Uwagi

Ta metoda jest dostarczana do kodowania dla wygody. Jest to równoważne wywołaniu RedirectPermanent(String, Boolean) metody z drugim parametrem ustawionym na falsewartość .

Ta metoda konwertuje nazwę trasy, routeName która jest przekazywana do adresu URL przy użyciu RouteCollection.GetVirtualPath metody .

ASP.NET wykonuje przekierowanie, zwracając kod stanu HTTP 301.

Zobacz też

• ASP.NET Routing

RedirectToRoutePermanent(RouteValueDictionary)

Wykonuje trwałe przekierowanie z żądanego adresu URL do nowego adresu URL przy użyciu wartości parametrów 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

Wartości parametrów trasy.

Wyjątki

InvalidOperationException

Żadna trasa nie odpowiada określonym parametrom trasy.

HttpException

Próba przekierowania została podjęta po wysłaniu nagłówków HTTP.

Przykłady

W poniższym przykładzie pokazano, jak wywołać tę metodę w celu przekierowania do trasy zawierającej parametry o nazwach productid i category.

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

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

Uwagi

Ta metoda jest dostarczana do kodowania dla wygody. Jest to równoważne wywołaniu Redirect(String, Boolean) metody z drugim parametrem ustawionym na falsewartość .

Ta metoda wywołuje metodę w RouteCollection.GetVirtualPath celu określenia adresu URL.

ASP.NET wykonuje przekierowanie, zwracając kod stanu HTTP 301.

Zobacz też

• ASP.NET Routing

RedirectToRoutePermanent(String, RouteValueDictionary)

Wykonuje trwałe przekierowanie z żądanego adresu URL do nowego adresu URL przy użyciu wartości parametrów trasy i nazwy 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

Nazwa trasy.

routeValues

RouteValueDictionary

Wartości parametrów trasy.

Wyjątki

InvalidOperationException

Żadna trasa nie odpowiada określonym parametrom trasy.

HttpException

Próba przekierowania została podjęta po wysłaniu nagłówków HTTP.

Przykłady

W poniższym przykładzie pokazano, jak wywołać tę metodę w celu przekierowania do trasy o nazwie i zawierającej parametry o nazwie Productproductid i category.

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

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

Uwagi

Ta metoda jest dostarczana do kodowania dla wygody. Jest to równoważne wywołaniu Redirect(String, Boolean) metody z drugim parametrem ustawionym na falsewartość .

Ta metoda wywołuje metodę w RouteCollection.GetVirtualPath celu określenia adresu URL.

ASP.NET wykonuje przekierowanie, zwracając kod stanu HTTP 301.

Zobacz też

• ASP.NET Routing