HttpServerUtility.Transfer Methode

Definition

Beendet die Ausführung der aktuellen Seite und startet die Ausführung einer neuen Seite für die aktuelle Anforderung.Terminates execution of the current page and starts execution of a new page for the current request.

Überlädt

Transfer(String)

Beendet für die aktuelle Anforderung die Ausführung der aktuellen Seite und startet die Ausführung einer neuen Seite unter Verwendung des angegebenen URL-Pfads für die Seite.For the current request, terminates execution of the current page and starts execution of a new page by using the specified URL path of the page.

Transfer(String, Boolean)

Beendet die Ausführung der aktuellen Seite und startet die Ausführung einer neuen Seite unter Verwendung des angegebenen URL-Pfads für die Seite.Terminates execution of the current page and starts execution of a new page by using the specified URL path of the page. Gibt an, ob die QueryString-Auflistung und die Form-Auflistung gelöscht werden soll.Specifies whether to clear the QueryString and Form collections.

Transfer(IHttpHandler, Boolean)

Beendet die Ausführung der aktuellen Seite und beginnt die Ausführung einer neuen Anforderung mithilfe eines benutzerdefinierten HTTP-Handlers, der die IHttpHandler-Schnittstelle implementiert und angibt, ob die QueryString-Auflistung und die Form-Auflistung gelöscht werden sollen.Terminates execution of the current page and starts execution of a new request by using a custom HTTP handler that implements the IHttpHandler interface and specifies whether to clear the QueryString and Form collections.

Transfer(String)

Beendet für die aktuelle Anforderung die Ausführung der aktuellen Seite und startet die Ausführung einer neuen Seite unter Verwendung des angegebenen URL-Pfads für die Seite.For the current request, terminates execution of the current page and starts execution of a new page by using the specified URL path of the page.

public:
 void Transfer(System::String ^ path);
public void Transfer (string path);
member this.Transfer : string -> unit
Public Sub Transfer (path As String)

Parameter

path
String

Der URL-Pfad für die neue auszuführende Seite auf dem Server.The URL path of the new page on the server to execute.

Hinweise

Die an übertragene Seite muss eine andere ASPX-Seite sein.The page transferred to should be another .aspx page. Beispielsweise ist eine Übertragung an eine ASP-oder ASMX-Seite ungültig.For instance, a transfer to an .asp or .asmx page is not valid. Die Transfer -Methode bewahrt QueryString die Form -Auflistung und die-Auflistung.The Transfer method preserves the QueryString and Form collections.

TransferRuft Endauf, wodurch beim ThreadAbortException Abschluss eine-Ausnahme ausgelöst wird.Transfer calls End, which throws a ThreadAbortException exception upon completion.

ASP.NET überprüft nicht, ob der aktuelle Benutzer autorisiert ist, die von der Transfer -Methode gelieferte Ressource anzuzeigen.ASP.NET does not verify that the current user is authorized to view the resource delivered by the Transfer method. Obwohl die ASP.net-Autorisierungs-und Authentifizierungs Logik vor dem Aufrufen des ursprünglichen Ressourcen Handlers ausgeführt wird, ruft ASP.net direkt Transfer den von der-Methode bezeichneten Handler auf und führt keine Authentifizierungs-und Autorisierungs Logik für den neuen Ressource.Although the ASP.NET authorization and authentication logic runs before the original resource handler is called, ASP.NET directly calls the handler indicated by the Transfer method and does not rerun authentication and authorization logic for the new resource. Wenn die Sicherheitsrichtlinie Ihrer Anwendung erfordert, dass Clients über die entsprechende Autorisierung für den Zugriff auf die Ressource verfügen, sollte die Anwendung die erneute Autorisierung erzwingen oder einen benutzerdefinierten Mechanismus zur Zugriffs Steuerung bereitstellen.If your application's security policy requires clients to have appropriate authorization to access the resource, the application should force reauthorization or provide a custom access-control mechanism.

Sie können die erneute Autorisierung erzwingen, Redirect indem Sie anstelle der Transfer -Methode die-Methode verwenden.You can force reauthorization by using the Redirect method instead of the Transfer method. Die Redirect -Methode führt eine Client seitige Umleitung aus, bei der der Browser die neue Ressource anfordert.The Redirect method performs a client-side redirect in which the browser requests the new resource. Da diese Umleitung eine neue Anforderung ist, die in das System eintritt, wird Sie der gesamten Authentifizierungs-und Autorisierungs Logik sowohl der Internetinformationsdienste (IIS) als auch der ASP.NET-Sicherheitsrichtlinie unterzogen.Because this redirect is a new request entering the system, it is subjected to all the authentication and authorization logic of both Internet Information Services (IIS) and ASP.NET security policy.

Sie können überprüfen, ob der Benutzer über die Berechtigung zum Anzeigen der Ressource verfügt, indem Sie eine Benutzer IsInRole definierte Autorisierungs Methode einbinden, Transfer die die Methode verwendet, bevor die Anwendung die-Methode aufruftYou can verify that the user has permission to view the resource by incorporating a custom authorization method that uses the IsInRole method before the application calls the Transfer method.

Transfer(String, Boolean)

Beendet die Ausführung der aktuellen Seite und startet die Ausführung einer neuen Seite unter Verwendung des angegebenen URL-Pfads für die Seite.Terminates execution of the current page and starts execution of a new page by using the specified URL path of the page. Gibt an, ob die QueryString-Auflistung und die Form-Auflistung gelöscht werden soll.Specifies whether to clear the QueryString and Form collections.

public:
 void Transfer(System::String ^ path, bool preserveForm);
public void Transfer (string path, bool preserveForm);
member this.Transfer : string * bool -> unit
Public Sub Transfer (path As String, preserveForm As Boolean)

Parameter

path
String

Der URL-Pfad für die neue auszuführende Seite auf dem Server.The URL path of the new page on the server to execute.

preserveForm
Boolean

true, um die QueryString-Auflistung und die Form-Auflistung beizubehalten, false, um die QueryString-Auflistung und die Form-Auflistung zu löschen.true to preserve the QueryString and Form collections; false to clear the QueryString and Form collections.

Ausnahmen

Die aktuelle Seitenanforderung ist ein Rückruf.The current page request is a callback.

Beispiele

Im folgenden Beispiel wird eine neue Seite im gleichen Verzeichnis wie die aktuelle Seite ausgeführt.The following example executes a new page in the same directory as the current page.

Server.Transfer("Logon.aspx", true);

Server.Transfer("Logon.aspx", true)

Hinweise

Die an übertragene Seite muss eine andere ASPX-Seite sein.The page transferred to should be another .aspx page. Beispielsweise ist eine Übertragung an eine ASP-oder ASMX-Seite ungültig.For instance, a transfer to an .asp or .asmx page is not valid.

TransferRuft Endauf, wodurch beim ThreadAbortException Abschluss eine-Ausnahme ausgelöst wird.Transfer calls End, which throws a ThreadAbortException exception upon completion.

Wenn Sie den preserveForm -Parameter auf truefestlegen, kann auf der Zielseite mithilfe der PreviousPage -Eigenschaft auf den Ansichts Zustand der vorherigen Seite zugegriffen werden.If you set the preserveForm parameter to true, the target page will be able to access the view state of the previous page by using the PreviousPage property.

Aus Sicherheitsgründen sollten Sie das enableViewStateMac -Attribut auf truefestgelegt halten.For security purposes, you should keep the enableViewStateMac attribute set to true. ASP.NET überprüft nicht, ob der aktuelle Benutzer autorisiert ist, die von der Transfer -Methode gelieferte Ressource anzuzeigen.ASP.NET does not verify that the current user is authorized to view the resource delivered by the Transfer method. Obwohl die ASP.net-Autorisierungs-und Authentifizierungs Logik vor dem Aufrufen des ursprünglichen Ressourcen Handlers ausgeführt wird, ruft ASP.net direkt Transfer den von der-Methode bezeichneten Handler auf und führt keine Authentifizierungs-und Autorisierungs Logik für den neuen Ressource.Although the ASP.NET authorization and authentication logic runs before the original resource handler is called, ASP.NET directly calls the handler indicated by the Transfer method and does not rerun authentication and authorization logic for the new resource. Wenn die Sicherheitsrichtlinie Ihrer Anwendung erfordert, dass Clients über die entsprechende Autorisierung für den Zugriff auf die Ressource verfügen, sollte die Anwendung die erneute Autorisierung erzwingen oder einen benutzerdefinierten Mechanismus zur Zugriffs Steuerung bereitstellen.If your application's security policy requires clients to have appropriate authorization to access the resource, the application should force reauthorization or provide a custom access-control mechanism.

Sie können die erneute Autorisierung erzwingen, Redirect indem Sie anstelle der Transfer -Methode die-Methode verwenden.You can force reauthorization by using the Redirect method instead of the Transfer method. Die Redirect -Methode führt eine Client seitige Umleitung aus, bei der der Browser die neue Ressource anfordert.The Redirect method performs a client-side redirect in which the browser requests the new resource. Da diese Umleitung eine neue Anforderung ist, die in das System eintritt, wird Sie der gesamten Authentifizierungs-und Autorisierungs Logik sowohl der Internetinformationsdienste (IIS) als auch der ASP.NET-Sicherheitsrichtlinie unterzogen.Because this redirect is a new request entering the system, it is subjected to all the authentication and authorization logic of both Internet Information Services (IIS) and ASP.NET security policy.

Sie können überprüfen, ob der Benutzer über die Berechtigung zum Anzeigen der Ressource verfügt, indem Sie eine Benutzer IsInRole definierte Autorisierungs Methode einbinden, Transfer die die Methode verwendet, bevor die Anwendung die-Methode aufruftYou can verify that the user has permission to view the resource by incorporating a custom authorization method that uses the IsInRole method before the application calls the Transfer method.

Transfer(IHttpHandler, Boolean)

Beendet die Ausführung der aktuellen Seite und beginnt die Ausführung einer neuen Anforderung mithilfe eines benutzerdefinierten HTTP-Handlers, der die IHttpHandler-Schnittstelle implementiert und angibt, ob die QueryString-Auflistung und die Form-Auflistung gelöscht werden sollen.Terminates execution of the current page and starts execution of a new request by using a custom HTTP handler that implements the IHttpHandler interface and specifies whether to clear the QueryString and Form collections.

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 -> unit
Public Sub Transfer (handler As IHttpHandler, preserveForm As Boolean)

Parameter

handler
IHttpHandler

Der HTTP-Handler, der den IHttpHandler implementiert, an den die aktuelle Anforderung übertragen werden soll.The HTTP handler that implements the IHttpHandler to transfer the current request to.

preserveForm
Boolean

true, um die QueryString-Auflistung und die Form-Auflistung beizubehalten, false, um die QueryString-Auflistung und die Form-Auflistung zu löschen.true to preserve the QueryString and Form collections; false to clear the QueryString and Form collections.

Ausnahmen

Die aktuelle Seitenanforderung ist ein Rückruf.The current page request is a callback.

Hinweise

Sie können benutzerdefinierte HTTP-Handler schreiben, um bestimmte, vordefinierte Typen von HTTP-Anforderungen in jeder Sprache zu verarbeiten, die mit den Common Language Specification (CLS) kompatibel ist.You can write custom HTTP handlers to process specific, predefined types of HTTP requests in any language that is compliant with the Common Language Specification (CLS). Ausführbarer Code, der in den HTTP-Handlerklassen anstelle von herkömmlichen ASP-Seiten (auch als klassisches ASP bezeichnet) oder ASP.NET-Seiten definiert ist, antwortet auf diese speziellen Anforderungen.Executable code that is defined in the HTTP handler classes instead of conventional ASP (also known as classic ASP) pages or ASP.NET pages responds to these specific requests. HTTP-Handler ermöglichen die Interaktion mit den Anforderungs-und Antwort Diensten auf niedriger Ebene eines Webservers, auf dem Internetinformationsdienste (IIS) ausgeführt wird, und bieten Funktionen, die ISAPI-Erweiterungen ähnlich sind, jedoch mit einem einfacheren Programmiermodell.HTTP handlers allow for interacting with the low-level request and response services of a Web server that is running Internet Information Services (IIS), and they provide functionality that is similar to ISAPI extensions but with a simpler programming model.

Wenn Sie den preserveForm -Parameter auf truefestlegen, kann auf der Zielseite mithilfe der PreviousPage -Eigenschaft auf den Ansichts Zustand der vorherigen Seite zugegriffen werden.If you set the preserveForm parameter to true, the target page will be able to access the view state of the previous page by using the PreviousPage property.

Aus Sicherheitsgründen sollten Sie das enableViewStateMac -Attribut auf truefestgelegt halten.For security purposes, you should keep the enableViewStateMac attribute set to true. ASP.NET überprüft nicht, ob der aktuelle Benutzer autorisiert ist, die von der Transfer -Methode gelieferte Ressource anzuzeigen.ASP.NET does not verify that the current user is authorized to view the resource delivered by the Transfer method. Obwohl die ASP.net-Autorisierungs-und Authentifizierungs Logik vor dem Aufrufen des ursprünglichen Ressourcen Handlers ausgeführt wird, ruft ASP.net direkt Transfer den von der-Methode bezeichneten Handler auf und führt keine Authentifizierungs-und Autorisierungs Logik für den neuen Ressource.Although the ASP.NET authorization and authentication logic runs before the original resource handler is called, ASP.NET directly calls the handler indicated by the Transfer method, and does not rerun authentication and authorization logic for the new resource. Wenn die Sicherheitsrichtlinie für Ihre Anwendung erfordert, dass Clients über die entsprechende Autorisierung für den Zugriff auf die Ressource verfügen, sollte die Anwendung die erneute Autorisierung erzwingen oder einen benutzerdefinierten Mechanismus zur Zugriffs Steuerung bereitstellen.If the security policy for your application requires clients to have appropriate authorization to access the resource, the application should force reauthorization or provide a custom access-control mechanism.

Sie können die erneute Autorisierung erzwingen, Redirect indem Sie anstelle der Transfer -Methode die-Methode verwenden.You can force reauthorization by using the Redirect method instead of the Transfer method. Die Redirect -Methode führt eine Client seitige Umleitung aus, bei der der Browser die neue Ressource anfordert.The Redirect method performs a client-side redirect in which the browser requests the new resource. Da diese Umleitung eine neue Anforderung ist, die in das System eintritt, wird Sie der gesamten Authentifizierungs-und Autorisierungs Logik der IIS-und ASP.NET-Sicherheitsrichtlinie unterzogen.Because this redirect is a new request entering the system, it is subjected to all the authentication and authorization logic of both the IIS and ASP.NET security policy.

Sie können überprüfen, ob der Benutzer über die Berechtigung zum Anzeigen der Ressource verfügt, indem Sie eine Benutzer IsInRole definierte Autorisierungs Methode einbinden, Transfer die die Methode verwendet, bevor die Anwendung die-Methode aufruftYou can verify that the user has permission to view the resource by incorporating a custom authorization method that uses the IsInRole method before the application calls the Transfer method.

Gilt für: