HttpServerUtility.TransferRequest Método

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

public void TransferRequest(string path);

member this.TransferRequest : string -> unit

Public Sub TransferRequest (path As String)

Parâmetros

Exceções

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.

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

Exceções

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.

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

Exceções

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.

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

Exceções

Observações

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