HttpServerUtility.TransferRequest Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

Realiza una ejecución asincrónica de la dirección URL especificada.

Sobrecargas

TransferRequest(String)	Realiza una ejecución asincrónica de la dirección URL especificada.
TransferRequest(String, Boolean)	Realiza una ejecución asincrónica de la dirección URL especificada y conserva los parámetros de cadena de consulta.
TransferRequest(String, Boolean, String, NameValueCollection)	Realiza una ejecución asincrónica de la dirección URL especificada mediante el método HTTP y los encabezados especificados.
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	Realiza una ejecución asincrónica de la dirección URL especificada mediante el método HTTP, los encabezados y la ruta de acceso especificados y, opcionalmente, conserva los valores de formulario y la identidad del usuario.

Comentarios

TransferRequest se introdujo en .NET Framework versión 3.5. Para obtener información de resumen sobre .NET Framework, consulte Versiones y dependencias.

TransferRequest(String)

Realiza una ejecución asincrónica de la dirección 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

Ruta de acceso url de la nueva página en el servidor que se va a ejecutar.

Excepciones

PlatformNotSupportedException

La solicitud requiere el modo de canalización integrado de IIS 7.0.

HttpException

El servidor no está disponible para controlar la solicitud.

ArgumentNullException

El parámetro path es null.

ArgumentException

El parámetro path no es válido.

Comentarios

Esta sobrecarga de método llama a la sobrecarga de TransferRequest con el parámetro preserveForm establecido en false, el parámetro method establecido en null, el parámetro headers establecido en nully el parámetro preserveUser establecido en true. Para obtener más información, vea la sección "Comentarios" en TransferRequest(String, Boolean, String, NameValueCollection) sobrecarga.

TransferRequest(String, Boolean)

Realiza una ejecución asincrónica de la dirección URL especificada y conserva los parámetros de cadena 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

Ruta de acceso url de la nueva página en el servidor que se va a ejecutar.

preserveForm

Boolean

true conservar la colección Form; false borrar la colección Form.

Excepciones

PlatformNotSupportedException

La solicitud requiere el modo de canalización integrado de IIS 7.0.

HttpException

El servidor no está disponible para controlar la solicitud.

ArgumentNullException

El parámetro path es null.

ArgumentException

El parámetro path no es válido.

Comentarios

Esta sobrecarga llama a la sobrecarga de TransferRequest con el parámetro preserveForm establecido en el valor pasado, el parámetro method establecido en null, el parámetro headers establecido en nully el parámetro preserveUser establecido en true. Para obtener más información, vea la sección "Comentarios" de TransferRequest(String, Boolean, String, NameValueCollection).

TransferRequest se introduce en .NET Framework versión 3.5. Para obtener más información, vea Versiones y dependencias.

TransferRequest(String, Boolean, String, NameValueCollection)

Realiza una ejecución asincrónica de la dirección URL especificada mediante el método HTTP y los encabezados 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

Ruta de acceso url de la nueva página en el servidor que se va a ejecutar.

preserveForm

Boolean

true conservar la colección Form; false borrar la colección Form.

method

String

Método HTTP que se va a usar en la ejecución de la nueva solicitud.

headers

NameValueCollection

Un NameValueCollection de encabezados de solicitud para la nueva solicitud.

Excepciones

PlatformNotSupportedException

La solicitud requiere IIS 7.0 en ejecución en modo integrado.

HttpException

El servidor no está disponible para controlar la solicitud.

ArgumentNullException

El parámetro path es null.

ArgumentException

El parámetro path no es válido.

Comentarios

Este método se usa cuando se ejecuta con el modo de canalización integrado en IIS 7.0 para permitir que el procesamiento de solicitudes se transfiera de un tipo de recurso a otro mientras se ejecuta la solicitud de destino con el contexto de solicitud correcto. Por ejemplo, puede usar el método TransferRequest para transferir una solicitud de una página ASPX a una solicitud de una página XML.

El método TransferRequest realiza una ejecución secundaria asincrónica de la dirección URL especificada con las siguientes condiciones:

• Si el parámetro path especifica una cadena de consulta, se usará como la nueva cadena de consulta. Si no se incluye ninguna cadena de consulta, se volverá a usar la cadena de consulta de la solicitud.

• Si se especifica el parámetro method, se usará. Si se null, se usará el método HTTP de la solicitud original.

• Si el parámetro preserveForm es true, el cuerpo de entidad actual de la solicitud estará disponible para la solicitud de destino. Esto permite transferir publicaciones y cargas de formularios.

• Si la identidad del usuario está establecida actualmente en la solicitud original, la identidad se transferirá a la nueva solicitud. Esto permite que las solicitudes autenticadas vuelvan a usar el resultado de la autenticación para la nueva solicitud. Si no desea que el usuario se transfiera, establezca el usuario en null en la solicitud original antes de transferirlo.

• Si se especifica el parámetro headers, la nueva solicitud se ejecutará con los encabezados especificados. Esto se puede usar para modificar los encabezados de solicitud y las cookies de la nueva solicitud, o agregar un encabezado especial que especifique dónde se recibió la solicitud original.

  Este método llama a la sobrecarga del método TransferRequest(String, Boolean, String, NameValueCollection, Boolean) con el parámetro preserveUser establecido en true.

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

Realiza una ejecución asincrónica de la dirección URL especificada mediante el método HTTP, los encabezados y la ruta de acceso especificados y, opcionalmente, conserva los valores de formulario y la identidad del usuario.

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

Ruta de acceso.

preserveForm

Boolean

true conservar la colección Form; false borrar la colección Form.

method

String

Método HTTP que se va a usar en la nueva solicitud.

headers

NameValueCollection

Objeto NameValueCollection que contiene encabezados de solicitud para la nueva solicitud.

preserveUser

Boolean

true conservar la identidad del usuario; de lo contrario, false. Las otras sobrecargas de método de este método llaman a esta sobrecarga con este parámetro establecido en true.

Excepciones

PlatformNotSupportedException

La solicitud requiere el modo de canalización integrado de IIS 7.0.

HttpException

El servidor no está disponible para controlar la solicitud.

ArgumentNullException

El parámetro path es null.

ArgumentException

El parámetro path no es válido.

Comentarios

Para obtener más información, vea la sección "Comentarios" de TransferRequest(String, Boolean, String, NameValueCollection).