HttpServerUtility.TransferRequest Método

Definición

Espacio de nombres:: System.Web

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

Sobrecargas

Nombre	Description
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 la versión 3.5 de .NET Framework. Para obtener información resumida sobre .NET Framework, vea Versions and Dependencies.

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 path parámetro es null.

ArgumentException

El path parámetro 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.

Se aplica a

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 para conservar la Form colección; false para borrar la Form colección.

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 path parámetro es null.

ArgumentException

El path parámetro 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" en TransferRequest(String, Boolean, String, NameValueCollection).

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

Se aplica a

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 para conservar la Form colección; false para borrar la Form colección.

method: String

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

headers: NameValueCollection

NameValueCollection un 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 path parámetro es null.

ArgumentException

El path parámetro 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 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 siguientes condiciones:

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 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 null en en la solicitud original antes de transferirlo.
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.

Se aplica a

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

La ruta de acceso.

preserveForm: Boolean

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

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 para 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 trueen .

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 path parámetro es null.

ArgumentException

El path parámetro no es válido.

Comentarios

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

Se aplica a

Comentaris

Us ha resultat útil aquesta pàgina?