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 y los encabezados HTTP especificados.
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	Realiza una ejecución asincrónica de la dirección URL especificada mediante el método, los encabezados y la ruta de acceso HTTP indicados, y conserva opcionalmente los valores del formulario y la identidad del usuario.

Comentarios

TransferRequestse introdujo en la versión 3.5 de .NET Framework. Para obtener información de resumen sobre el .NET Framework, vea 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

Dirección 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 atender 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 TransferRequest sobrecarga con el preserveForm parámetro establecido falseen , el method parámetro establecido nullen , el headers parámetro establecido nullen y el preserveUser parámetro 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

Dirección URL de la nueva página en el servidor que se va a ejecutar.

preserveForm

Boolean

true para preservar la colección Form; false para 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 atender la solicitud.

ArgumentNullException

El parámetro path es null.

ArgumentException

El parámetro path no es válido.

Comentarios

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

TransferRequestse introduce en la versión 3.5 de .NET Framework. Para 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 y los encabezados HTTP 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

Dirección URL de la nueva página en el servidor que se va a ejecutar.

preserveForm

Boolean

true para preservar la colección Form; false para 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

NameValueCollection de encabezados de solicitud para la nueva solicitud.

Excepciones

PlatformNotSupportedException

La solicitud requiere que IIS 7.0 se ejecute en modo integrado.

HttpException

El servidor no está disponible para atender 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 integrada 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 TransferRequest método para transferir una solicitud de una página ASPX a una solicitud de una página XML.

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

• Si el path parámetro 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 method parámetro , se usará. Si es null, se usará el método HTTP de la solicitud original.

• Si el preserveForm parámetro es true, el cuerpo de entidad actual de la solicitud estará disponible para la solicitud de destino. Esto permite transferir entradas 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 null en en la solicitud original antes de la transferencia.

• Si se especifica el headers parámetro , 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 TransferRequest(String, Boolean, String, NameValueCollection, Boolean) método con el preserveUser parámetro 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, los encabezados y la ruta de acceso HTTP indicados, y conserva opcionalmente los valores del 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

La ruta de acceso.

preserveForm

Boolean

true para preservar la colección Form; false para borrar la colección Form.

method

String

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

headers

NameValueCollection

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

preserveUser

Boolean

true para conservar la identidad del usuario; si no, false. Otras sobrecargas 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 atender 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).