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

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.

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

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.

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

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.

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

Comentários

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