HttpServerUtility.TransferRequest Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

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

Sobrecargas

TransferRequest(String)	Realiza 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 da cadeia de consulta.
TransferRequest(String, Boolean, String, NameValueCollection)	Realiza a execução assíncrona da URL especificada usando o método HTTP e os cabeçalhos especificados.
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	Realiza a execução assíncrona da URL especificada usando o caminho, os cabeçalhos e o método HTTP especificados e, opcionalmente, preserva os valores de formulário e a identidade do usuário.

Comentários

TransferRequestfoi introduzido no .NET Framework versão 3.5. Para obter 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 de URL da nova página no servidor de execuçã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 manipular a solicitação.

ArgumentNullException

O parâmetro path é 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 nulle 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.

TransferRequest(String, Boolean)

Executa 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 de URL da nova página no servidor de execução.

preserveForm

Boolean

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

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 manipular a solicitação.

ArgumentNullException

O parâmetro path é 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 nulle 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 saber mais, confira Versões e dependências.

TransferRequest(String, Boolean, String, NameValueCollection)

Realiza a 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 de URL da nova página no servidor de execução.

preserveForm

Boolean

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

method

String

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

headers

NameValueCollection

Um NameValueCollection de 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 manipular a solicitação.

ArgumentNullException

O parâmetro path é null.

ArgumentException

O parâmetro path é inválido.

Comentários

Esse método é usado ao ser executado 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 e uploads de formulários 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 as 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 e cookies de solicitação 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.

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

Realiza a execução assíncrona da URL especificada usando o caminho, os cabeçalhos e o método HTTP especificados e, opcionalmente, preserva os 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 coleção Form; false para limpar a coleção Form.

method

String

O método HTTP usado na nova solicitação.

headers

NameValueCollection

Um objeto NameValueCollection 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 do 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 manipular a solicitação.

ArgumentNullException

O parâmetro path é 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).