HttpServerUtility.TransferRequest Método

Definição

Espaço de Nomes:

System.Web

Assemblagem:

System.Web.dll

Realiza uma execução assíncrona da URL especificada.

Sobrecargas

Name	Description
TransferRequest(String)	Realiza uma execução assíncrona da URL especificada.
TransferRequest(String, Boolean)	Realiza uma execução assíncrona da URL especificada e preserva os parâmetros da cadeia de consulta.
TransferRequest(String, Boolean, String, NameValueCollection)	Realiza uma execução assíncrona da URL especificada usando o método HTTP e os cabeçalhos especificados.
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	Realiza uma execução assíncrona do URL especificado usando o método HTTP especificado, cabeçalhos e caminho, e opcionalmente preserva os valores do formulário e a identidade do utilizador.

Observações

TransferRequest foi introduzido na versão 3.5 do .NET Framework. Para informações resumidas sobre o .NET Framework, consulte Versões e Dependências.

TransferRequest(String)

Realiza uma execução assíncrona da URL especificada.

public:
 void TransferRequest(System::String ^ path);

public void TransferRequest(string path);

member this.TransferRequest : string -> unit

Public Sub TransferRequest (path As String)

Parâmetros

path

String

O caminho da URL da nova página no servidor para executar.

Exceções

PlatformNotSupportedException

O pedido requer o modo pipeline integrado do IIS 7.0.

HttpException

O servidor não está disponível para tratar do pedido.

ArgumentNullException

O path parâmetro é null.

ArgumentException

O path parâmetro é inválido.

Observações

Esta sobrecarga de método chama a TransferRequest sobrecarga com o preserveForm parâmetro definido para false, o method parâmetro definido para null, o headers parâmetro definido para null, e o preserveUser parâmetro definido para true. Para mais informações, consulte a secção "Observações" em TransferRequest(String, Boolean, String, NameValueCollection) sobrecarga.

TransferRequest(String, Boolean)

Realiza uma execução assíncrona da URL especificada e preserva os parâmetros da cadeia de consulta.

public:
 void TransferRequest(System::String ^ path, bool preserveForm);

public void TransferRequest(string path, bool preserveForm);

member this.TransferRequest : string * bool -> unit

Public Sub TransferRequest (path As String, preserveForm As Boolean)

Parâmetros

path

String

O caminho da URL da nova página no servidor para executar.

preserveForm

Boolean

true para preservar a Form coleção; false para limpar a Form coleção.

Exceções

PlatformNotSupportedException

O pedido requer o modo pipeline integrado do IIS 7.0.

HttpException

O servidor não está disponível para tratar do pedido.

ArgumentNullException

O path parâmetro é null.

ArgumentException

O path parâmetro é inválido.

Observações

Esta sobrecarga chama a TransferRequest sobrecarga com o preserveForm parâmetro definido ao valor passado em, o method parâmetro definido a null, o headers parâmetro definido a null, e o preserveUser parâmetro definido a true. Para mais informações, consulte a secção "Observações" em TransferRequest(String, Boolean, String, NameValueCollection).

TransferRequest é introduzido na versão 3.5 do .NET Framework. Para mais informações, consulte Versões e Dependências.

TransferRequest(String, Boolean, String, NameValueCollection)

Realiza uma execução assíncrona da URL especificada usando o método HTTP e os cabeçalhos especificados.

public:
 void TransferRequest(System::String ^ path, bool preserveForm, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ headers);

public void TransferRequest(string path, bool preserveForm, string method, System.Collections.Specialized.NameValueCollection headers);

member this.TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection -> unit

Public Sub TransferRequest (path As String, preserveForm As Boolean, method As String, headers As NameValueCollection)

Parâmetros

path

String

O caminho da URL da nova página no servidor para executar.

preserveForm

Boolean

true para preservar a Form coleção; false para limpar a Form coleção.

method

String

O método HTTP a usar na execução do novo pedido.

headers

NameValueCollection

Um NameValueCollection de cabeçalhos de pedido para o novo pedido.

Exceções

PlatformNotSupportedException

O pedido requer o IIS 7.0 a correr em modo integrado.

HttpException

O servidor não está disponível para tratar do pedido.

ArgumentNullException

O path parâmetro é null.

ArgumentException

O path parâmetro é inválido.

Observações

Este método é utilizado quando é executado com o modo pipeline integrado no IIS 7.0 para permitir que o processamento de pedidos seja transferido de um tipo de recurso para outro enquanto se executa o pedido alvo com o contexto de pedido correto. Por exemplo, pode usar o TransferRequest método para transferir um pedido para uma página ASPX para um pedido para uma página XML.

O TransferRequest método executa uma filha assíncrona da URL especificada com as seguintes condições:

• Se o path parâmetro especificar uma cadeia de consulta, será usada como nova cadeia de consulta. Se não for incluída nenhuma cadeia de consulta, a cadeia de consulta do pedido será reutilizada.

• Se o method parâmetro for especificado, será utilizado. Se for null, será utilizado o método HTTP do pedido original.

• Se o preserveForm parâmetro for true, o corpo atual da entidade do pedido estará disponível para o pedido alvo. Isto permite transferir publicações e uploads de formulários.

• Se a identidade do utilizador estiver atualmente definida no pedido original, a identidade será transferida para o novo pedido. Isto permite que os pedidos autenticados reutilizem o resultado da autenticação para o novo pedido. Se não quiser que o utilizador seja transferido, defina o utilizador como null no pedido original antes de transferir.

• Se o headers parâmetro for especificado, o novo pedido será executado com os cabeçalhos especificados. Isto pode ser usado para modificar os cabeçalhos e cookies do pedido para o novo pedido, ou adicionar um cabeçalho especial que especifique onde o pedido original foi recebido.

  Este método chama o TransferRequest(String, Boolean, String, NameValueCollection, Boolean) método overload com o preserveUser parâmetro definido em true.

TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

Realiza uma execução assíncrona do URL especificado usando o método HTTP especificado, cabeçalhos e caminho, e opcionalmente preserva os valores do formulário e a identidade do utilizador.

public:
 void TransferRequest(System::String ^ path, bool preserveForm, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ headers, bool preserveUser);

public void TransferRequest(string path, bool preserveForm, string method, System.Collections.Specialized.NameValueCollection headers, bool preserveUser);

member this.TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection * bool -> unit

Public Sub TransferRequest (path As String, preserveForm As Boolean, method As String, headers As NameValueCollection, preserveUser As Boolean)

Parâmetros

path

String

O caminho.

preserveForm

Boolean

true para preservar a Form coleção; false para limpar a Form coleção.

method

String

O método HTTP a usar no novo pedido.

headers

NameValueCollection

Um NameValueCollection objeto que contém cabeçalhos de pedido para o novo pedido.

preserveUser

Boolean

true preservar a identidade do utilizador; caso contrário, false. As outras sobrecargas deste método chamam a esta sobrecarga com este parâmetro definido em true.

Exceções

PlatformNotSupportedException

O pedido requer o modo pipeline integrado do IIS 7.0.

HttpException

O servidor não está disponível para tratar do pedido.

ArgumentNullException

O path parâmetro é null.

ArgumentException

O path parâmetro é inválido.

Observações

Para mais informações, consulte a secção "Observações" em TransferRequest(String, Boolean, String, NameValueCollection).