HttpServerUtility.Transfer Methode

public:
 void Transfer(System::String ^ path);

public void Transfer (string path);

member this.Transfer : string -> unit

Public Sub Transfer (path As String)

Parameter

Hinweise

Die zu übertragene Seite sollte eine andere ASPX-Seite sein. Beispielsweise ist eine Übertragung auf eine ASP- oder ASMX-Seite ungültig. Die Transfer Methode behält die QueryString Und-Auflistungen Form bei.

Transfer Aufrufe End, die nach Abschluss eine ThreadAbortException Ausnahme auslösen.

ASP.NET überprüft nicht, ob der aktuelle Benutzer berechtigt ist, die von der Transfer Methode bereitgestellte Ressource anzuzeigen. Obwohl die ASP.NET Autorisierungs- und Authentifizierungslogik ausgeführt wird, bevor der ursprüngliche Ressourcenhandler aufgerufen wird, ruft ASP.NET den durch die Transfer Methode angegebenen Handler direkt auf und führt die Authentifizierungs- und Autorisierungslogik für die neue Ressource nicht erneut aus. Wenn die Sicherheitsrichtlinie Ihrer Anwendung clients die entsprechende Autorisierung für den Zugriff auf die Ressource erfordert, sollte die Anwendung die Erneute Dokumenterstellung erzwingen oder einen benutzerdefinierten Zugriffssteuerungsmechanismus bereitstellen.

Sie können die Erneute Dokumenterstellung erzwingen, indem Sie die Redirect Methode anstelle der Transfer Methode verwenden. Die Redirect Methode führt eine clientseitige Umleitung aus, in der der Browser die neue Ressource anfordert. Da diese Umleitung eine neue Anforderung ist, die das System eingibt, wird sie allen Authentifizierungs- und Autorisierungslogiken von Internetinformationsdienste (IIS) und ASP.NET Sicherheitsrichtlinie unterliegen.

Sie können überprüfen, ob der Benutzer über die Berechtigung zum Anzeigen der Ressource verfügt, indem Sie eine benutzerdefinierte Autorisierungsmethode einbeziehen, die die IsInRole Methode verwendet, bevor die Anwendung die Transfer Methode aufruft.

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

Ausnahmen

Beispiele

Im folgenden Beispiel wird eine neue Seite im selben Verzeichnis wie die aktuelle Seite ausgeführt.

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

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

Hinweise

Die zu übertragene Seite sollte eine andere ASPX-Seite sein. Beispielsweise ist eine Übertragung auf eine ASP- oder ASMX-Seite ungültig.

Transfer Aufrufe End, die nach Abschluss eine ThreadAbortException Ausnahme auslösen.

Wenn Sie den preserveForm Parameter trueauf festlegen, kann die Zielseite mithilfe der PreviousPage Eigenschaft auf den Ansichtsstatus der vorherigen Seite zugreifen.

Für Sicherheitszwecke sollten Sie das enableViewStateMac Attribut auf festlegen true. ASP.NET überprüft nicht, ob der aktuelle Benutzer berechtigt ist, die von der Transfer Methode bereitgestellte Ressource anzuzeigen. Obwohl die ASP.NET Autorisierungs- und Authentifizierungslogik ausgeführt wird, bevor der ursprüngliche Ressourcenhandler aufgerufen wird, ruft ASP.NET den durch die Transfer Methode angegebenen Handler direkt auf und führt die Authentifizierungs- und Autorisierungslogik für die neue Ressource nicht erneut aus. Wenn die Sicherheitsrichtlinie Ihrer Anwendung clients die entsprechende Autorisierung für den Zugriff auf die Ressource erfordert, sollte die Anwendung die Erneute Dokumenterstellung erzwingen oder einen benutzerdefinierten Zugriffssteuerungsmechanismus bereitstellen.

Sie können die Erneute Dokumenterstellung erzwingen, indem Sie die Redirect Methode anstelle der Transfer Methode verwenden. Die Redirect Methode führt eine clientseitige Umleitung aus, in der der Browser die neue Ressource anfordert. Da diese Umleitung eine neue Anforderung ist, die das System eingibt, wird sie allen Authentifizierungs- und Autorisierungslogiken von Internetinformationsdienste (IIS) und ASP.NET Sicherheitsrichtlinie unterliegen.

Sie können überprüfen, ob der Benutzer über die Berechtigung zum Anzeigen der Ressource verfügt, indem Sie eine benutzerdefinierte Autorisierungsmethode einbeziehen, die die IsInRole Methode verwendet, bevor die Anwendung die Transfer Methode aufruft.

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

Ausnahmen

Hinweise

Sie können benutzerdefinierte HTTP-Handler schreiben, um bestimmte, vordefinierte Typen von HTTP-Anforderungen in jeder Sprache zu verarbeiten, die mit der Common Language Specification (CLS) kompatibel ist. Ausführbarer Code, der in den HTTP-Handlerklassen definiert ist, anstatt herkömmliche ASP-Seiten (auch als klassische ASP-Seiten bezeichnet) oder ASP.NET Seiten reagieren auf diese spezifischen Anforderungen. HTTP-Handler ermöglichen die Interaktion mit den Anforderungs- und Antwortdiensten auf niedriger Ebene eines Webservers, der Internetinformationsdienste (IIS) ausführt, und sie bieten Funktionen, die mit ISAPI-Erweiterungen vergleichbar sind, aber mit einem einfacheren Programmiermodell.

Wenn Sie den preserveForm Parameter trueauf festlegen, kann die Zielseite mithilfe der PreviousPage Eigenschaft auf den Ansichtsstatus der vorherigen Seite zugreifen.

Für Sicherheitszwecke sollten Sie das enableViewStateMac Attribut auf festlegen true. ASP.NET überprüft nicht, ob der aktuelle Benutzer berechtigt ist, die von der Transfer Methode bereitgestellte Ressource anzuzeigen. Obwohl die ASP.NET Autorisierungs- und Authentifizierungslogik ausgeführt wird, bevor der ursprüngliche Ressourcenhandler aufgerufen wird, ruft ASP.NET den durch die Transfer Methode angegebenen Handler direkt auf und führt keine Authentifizierungs- und Autorisierungslogik für die neue Ressource erneut aus. Wenn die Sicherheitsrichtlinie für Ihre Anwendung Clients benötigt, um auf die Ressource zuzugreifen, sollte die Anwendung die erneute Dokumenterstellung erzwingen oder einen benutzerdefinierten Zugriffssteuerungsmechanismus bereitstellen.

Sie können die Erneute Dokumenterstellung erzwingen, indem Sie die Redirect Methode anstelle der Transfer Methode verwenden. Die Redirect Methode führt eine clientseitige Umleitung aus, in der der Browser die neue Ressource anfordert. Da diese Umleitung eine neue Anforderung ist, die das System eingibt, wird sie allen Authentifizierungs- und Autorisierungslogik sowohl der IIS- als auch ASP.NET Sicherheitsrichtlinie unterliegen.

Sie können überprüfen, ob der Benutzer über die Berechtigung zum Anzeigen der Ressource verfügt, indem Sie eine benutzerdefinierte Autorisierungsmethode einbeziehen, die die IsInRole Methode verwendet, bevor die Anwendung die Transfer Methode aufruft.