HttpServerUtility.TransferRequest Método

Definição

Namespace:: System.Web

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Sobrecargas

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

Comentários

TransferRequest foi introduzido no .NET Framework versão 3.5. Para obter informações resumidas sobre o .NET Framework, consulte Versions and Dependencies.

TransferRequest(String)

Executa 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 a ser executado.

Exceções

PlatformNotSupportedException

A solicitação requer o modo de pipeline integrado do IIS 7.0.

HttpException

O servidor não está disponível para lidar com a solicitação.

ArgumentNullException

O path parâmetro é null.

ArgumentException

O parâmetro path é inválido.

Comentários

Essa sobrecarga de método chama a TransferRequest sobrecarga com o preserveForm parâmetro definido como false, o method parâmetro definido como null, o headers parâmetro definido como null, e o preserveUser parâmetro definido como true. Para obter mais informações, consulte a seção "Comentários" em TransferRequest(String, Boolean, String, NameValueCollection) sobrecarga.

Aplica-se a

TransferRequest(String, Boolean)

Executa uma execução assíncrona da URL especificada e preserva os parâmetros de cadeia de caracteres 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 a ser executado.

preserveForm: Boolean

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

Exceções

PlatformNotSupportedException

A solicitação requer o modo de pipeline integrado do IIS 7.0.

HttpException

O servidor não está disponível para lidar com a solicitação.

ArgumentNullException

O path parâmetro é null.

ArgumentException

O parâmetro path é inválido.

Comentários

Essa sobrecarga chama a TransferRequest sobrecarga com o preserveForm parâmetro definido como o valor passado, o method parâmetro definido como null, o headers parâmetro definido como null, e o preserveUser parâmetro definido como true. Para obter mais informações, consulte a seção "Comentários" em TransferRequest(String, Boolean, String, NameValueCollection).

TransferRequest é introduzido no .NET Framework versão 3.5. Para obter mais informações, consulte Versões e dependências.

Aplica-se a

TransferRequest(String, Boolean, String, NameValueCollection)

Executa 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 a ser executado.

preserveForm: Boolean

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

method: String

O método HTTP a ser usado na execução da nova solicitação.

headers: NameValueCollection

Um NameValueCollection dos cabeçalhos de solicitação para a nova solicitação.

Exceções

PlatformNotSupportedException

A solicitação requer o IIS 7.0 em execução no modo integrado.

HttpException

O servidor não está disponível para lidar com a solicitação.

ArgumentNullException

O path parâmetro é null.

ArgumentException

O parâmetro path é inválido.

Comentários

Esse método é usado ao executar com o modo de pipeline integrado no IIS 7.0 para permitir que o processamento de solicitações seja transferido de um tipo de recurso para outro durante a execução da solicitação de destino com o contexto de solicitação correto. Por exemplo, você pode usar o TransferRequest método para transferir uma solicitação de uma página ASPX para uma solicitação de uma página XML.

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

Se o path parâmetro especificar uma cadeia de caracteres de consulta, ele será usado como a nova cadeia de caracteres de consulta. Se nenhuma cadeia de caracteres de consulta for incluída, a cadeia de caracteres de consulta da solicitação será reutilizado.
Se o method parâmetro for especificado, ele será usado. Se for null, o método HTTP da solicitação original será usado.
Se o preserveForm parâmetro for true, o corpo da entidade atual da solicitação estará disponível para a solicitação de destino. Isso permite que postagens de formulário e uploads sejam transferidos.
Se a identidade do usuário estiver definida na solicitação original, a identidade será transferida para a nova solicitação. Isso permite que solicitações autenticadas reutilizem o resultado da autenticação para a nova solicitação. Se você não quiser que o usuário seja transferido, defina o usuário null na solicitação original antes de transferir.
Se o headers parâmetro for especificado, a nova solicitação será executada com os cabeçalhos especificados. Isso pode ser usado para modificar os cabeçalhos de solicitação e cookies para a nova solicitação ou adicionar um cabeçalho especial que especifica onde a solicitação original foi recebida.

Esse método chama a sobrecarga do TransferRequest(String, Boolean, String, NameValueCollection, Boolean) método com o preserveUser parâmetro definido como true.

Aplica-se a

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

Executa uma execução assíncrona da URL especificada usando o método HTTP, cabeçalhos e caminho especificados e, opcionalmente, preserva valores de formulário e a identidade do usuário.

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 ser usado na nova solicitação.

headers: NameValueCollection

Um NameValueCollection objeto que contém cabeçalhos de solicitação para a nova solicitação.

preserveUser: Boolean

true para preservar a identidade do usuário; caso contrário, false. As outras sobrecargas de método desse método chamam essa sobrecarga com esse parâmetro definido como true.

Exceções

PlatformNotSupportedException

A solicitação requer o modo de pipeline integrado do IIS 7.0.

HttpException

O servidor não está disponível para lidar com a solicitação.

ArgumentNullException

O path parâmetro é null.

ArgumentException

O parâmetro path é inválido.

Comentários

Para obter mais informações, consulte a seção "Comentários" em TransferRequest(String, Boolean, String, NameValueCollection).

Aplica-se a

Comentários

Esta página foi útil?