HttpServerUtility.Transfer Método
Definición
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í.
Finaliza la ejecución de la página actual e inicia la ejecución de una nueva página para la solicitud actual.
Sobrecargas
| Transfer(String) |
En el caso de la solicitud actual, finaliza la ejecución de la página actual e inicia la ejecución de una nueva página mediante la dirección URL de la página. |
| Transfer(String, Boolean) |
Finaliza la ejecución de la página actual e inicia la ejecución de una nueva página mediante la dirección URL de la página. Especifica si borrar las colecciones QueryString y Form. |
| Transfer(IHttpHandler, Boolean) |
Finaliza la ejecución de la página actual e inicia la ejecución de una nueva solicitud utilizando un controlador HTTP personalizado que implementa la interfaz IHttpHandler, y especifica si se deben borrar las colecciones de QueryString y Form. |
Transfer(String)
En el caso de la solicitud actual, finaliza la ejecución de la página actual e inicia la ejecución de una nueva página mediante la dirección URL de la página.
public:
void Transfer(System::String ^ path);public void Transfer (string path);member this.Transfer : string -> unitPublic Sub Transfer (path As String)Parámetros
- path
- String
Dirección URL de la nueva página en el servidor que se va a ejecutar.
Comentarios
La página transferida a debe ser otra página .aspx. Por ejemplo, una transferencia a una página .asp o .asmx no es válida. El Transfer método conserva las QueryString colecciones y Form .
Transfer llama a End, que produce una ThreadAbortException excepción tras la finalización.
ASP.NET no comprueba que el usuario actual esté autorizado para ver el recurso entregado por el Transfer método . Aunque la lógica de autenticación y autorización de ASP.NET se ejecuta antes de llamar al controlador de recursos original, ASP.NET llama directamente al controlador indicado por el Transfer método y no vuelve a ejecutar la lógica de autenticación y autorización para el nuevo recurso. Si la directiva de seguridad de la aplicación requiere que los clientes tengan la autorización adecuada para acceder al recurso, la aplicación debe forzar la reautorización o proporcionar un mecanismo de control de acceso personalizado.
Puede forzar la reautorización mediante el Redirect método en lugar del Transfer método . El Redirect método realiza una redirección del lado cliente en la que el explorador solicita el nuevo recurso. Dado que este redireccionamiento es una nueva solicitud que entra en el sistema, está sujeta a toda la lógica de autenticación y autorización de Internet Information Services (IIS) y ASP.NET directiva de seguridad.
Puede comprobar que el usuario tiene permiso para ver el recurso mediante la incorporación de un método de autorización personalizado que usa el IsInRole método antes de que la aplicación llame al Transfer método .
Se aplica a
Transfer(String, Boolean)
Finaliza la ejecución de la página actual e inicia la ejecución de una nueva página mediante la dirección URL de la página. Especifica si borrar las colecciones QueryString y Form.
public:
void Transfer(System::String ^ path, bool preserveForm);public void Transfer (string path, bool preserveForm);member this.Transfer : string * bool -> unitPublic Sub Transfer (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 mantener las colecciones QueryString y Form; false para borrar las colecciones QueryString y Form.
Excepciones
La solicitud de página actual es una devolución de llamada.
Ejemplos
En el ejemplo siguiente se ejecuta una nueva página en el mismo directorio que la página actual.
Server.Transfer("Logon.aspx", true);
Server.Transfer("Logon.aspx", true)
Comentarios
La página transferida a debe ser otra página .aspx. Por ejemplo, una transferencia a una página .asp o .asmx no es válida.
Transfer llama a End, que produce una ThreadAbortException excepción tras la finalización.
Si establece el preserveForm parámetro trueen , la página de destino podrá acceder al estado de vista de la página anterior mediante la PreviousPage propiedad .
Para fines de seguridad, debe mantener el enableViewStateMac atributo establecido trueen . ASP.NET no comprueba que el usuario actual esté autorizado para ver el recurso entregado por el Transfer método . Aunque la lógica de autenticación y autorización de ASP.NET se ejecuta antes de llamar al controlador de recursos original, ASP.NET llama directamente al controlador indicado por el Transfer método y no vuelve a ejecutar la lógica de autenticación y autorización para el nuevo recurso. Si la directiva de seguridad de la aplicación requiere que los clientes tengan la autorización adecuada para acceder al recurso, la aplicación debe forzar la reautorización o proporcionar un mecanismo de control de acceso personalizado.
Puede forzar la reautorización mediante el Redirect método en lugar del Transfer método . El Redirect método realiza una redirección del lado cliente en la que el explorador solicita el nuevo recurso. Dado que este redireccionamiento es una nueva solicitud que entra en el sistema, está sujeta a toda la lógica de autenticación y autorización de Internet Information Services (IIS) y ASP.NET directiva de seguridad.
Puede comprobar que el usuario tiene permiso para ver el recurso mediante la incorporación de un método de autorización personalizado que usa el IsInRole método antes de que la aplicación llame al Transfer método .
Se aplica a
Transfer(IHttpHandler, Boolean)
Finaliza la ejecución de la página actual e inicia la ejecución de una nueva solicitud utilizando un controlador HTTP personalizado que implementa la interfaz IHttpHandler, y especifica si se deben borrar las colecciones de QueryString y Form.
public:
void Transfer(System::Web::IHttpHandler ^ handler, bool preserveForm);public void Transfer (System.Web.IHttpHandler handler, bool preserveForm);member this.Transfer : System.Web.IHttpHandler * bool -> unitPublic Sub Transfer (handler As IHttpHandler, preserveForm As Boolean)Parámetros
- handler
- IHttpHandler
Controlador HTTP que implementa la interfaz IHttpHandler a la que se va a transferir la solicitud actual.
- preserveForm
- Boolean
true para mantener las colecciones QueryString y Form; false para borrar las colecciones QueryString y Form.
Excepciones
La solicitud de página actual es una devolución de llamada.
Comentarios
Puede escribir controladores HTTP personalizados para procesar tipos predefinidos específicos de solicitudes HTTP en cualquier lenguaje que sea compatible con Common Language Specification (CLS). El código ejecutable que se define en las clases de controlador HTTP en lugar de las páginas ASP convencionales (también conocidas como ASP clásicas) o ASP.NET páginas responde a estas solicitudes específicas. Los controladores HTTP permiten interactuar con los servicios de solicitud y respuesta de bajo nivel de un servidor web que ejecuta Internet Information Services (IIS) y proporcionan una funcionalidad similar a las extensiones ISAPI, pero con un modelo de programación más sencillo.
Si establece el preserveForm parámetro trueen , la página de destino podrá acceder al estado de vista de la página anterior mediante la PreviousPage propiedad .
Para fines de seguridad, debe mantener el enableViewStateMac atributo establecido trueen . ASP.NET no comprueba que el usuario actual esté autorizado para ver el recurso entregado por el Transfer método . Aunque la lógica de autenticación y autorización de ASP.NET se ejecuta antes de llamar al controlador de recursos original, ASP.NET llama directamente al controlador indicado por el Transfer método y no vuelve a ejecutar la lógica de autenticación y autorización para el nuevo recurso. Si la directiva de seguridad de la aplicación requiere que los clientes tengan la autorización adecuada para acceder al recurso, la aplicación debe forzar la reautorización o proporcionar un mecanismo de control de acceso personalizado.
Puede forzar la reautorización mediante el Redirect método en lugar del Transfer método . El Redirect método realiza una redirección del lado cliente en la que el explorador solicita el nuevo recurso. Dado que este redireccionamiento es una nueva solicitud que entra en el sistema, está sujeta a toda la lógica de autenticación y autorización tanto de IIS como de ASP.NET directiva de seguridad.
Puede comprobar que el usuario tiene permiso para ver el recurso mediante la incorporación de un método de autorización personalizado que usa el IsInRole método antes de que la aplicación llame al Transfer método .
