HttpServerUtility.TransferRequest Methode

Definitie

Naamruimte:

System.Web

Assembly:

System.Web.dll

Voert een asynchrone uitvoering van de opgegeven URL uit.

Overloads

Name	Description
TransferRequest(String)	Voert een asynchrone uitvoering van de opgegeven URL uit.
TransferRequest(String, Boolean)	Voert een asynchrone uitvoering van de opgegeven URL uit en behoudt queryreeksparameters.
TransferRequest(String, Boolean, String, NameValueCollection)	Voert een asynchrone uitvoering van de opgegeven URL uit met behulp van de opgegeven HTTP-methode en headers.
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	Voert een asynchrone uitvoering van de opgegeven URL uit met behulp van de opgegeven HTTP-methode, headers en pad, en behoudt eventueel formulierwaarden en de gebruikersidentiteit.

Opmerkingen

TransferRequest is geïntroduceerd in de .NET Framework versie 3.5. Zie Versies en afhankelijkheden voor overzichtsinformatie over het .NET Framework.

TransferRequest(String)

Voert een asynchrone uitvoering van de opgegeven URL uit.

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

public void TransferRequest(string path);

member this.TransferRequest : string -> unit

Public Sub TransferRequest (path As String)

Parameters

path

String

Het URL-pad van de nieuwe pagina op de server die moet worden uitgevoerd.

Uitzonderingen

PlatformNotSupportedException

Voor de aanvraag is de geïntegreerde pijplijnmodus van IIS 7.0 vereist.

HttpException

De server is niet beschikbaar om de aanvraag te verwerken.

ArgumentNullException

De path parameter is null.

ArgumentException

De path parameter is ongeldig.

Opmerkingen

Met deze methode wordt de TransferRequest overbelasting aangeroepen met de preserveForm parameterset op false, de method parameter ingesteld op null, de headers parameter ingesteld op nullen de preserveUser parameter ingesteld op true. Zie de sectie Opmerkingen in TransferRequest(String, Boolean, String, NameValueCollection) overbelasting voor meer informatie.

TransferRequest(String, Boolean)

Voert een asynchrone uitvoering van de opgegeven URL uit en behoudt queryreeksparameters.

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)

Parameters

path

String

Het URL-pad van de nieuwe pagina op de server die moet worden uitgevoerd.

preserveForm

Boolean

true om de Form verzameling te behouden; false om de Form verzameling te wissen.

Uitzonderingen

PlatformNotSupportedException

Voor de aanvraag is de geïntegreerde pijplijnmodus van IIS 7.0 vereist.

HttpException

De server is niet beschikbaar om de aanvraag te verwerken.

ArgumentNullException

De path parameter is null.

ArgumentException

De path parameter is ongeldig.

Opmerkingen

Deze overbelasting roept de TransferRequest overbelasting aan met de preserveForm parameter die is ingesteld op de waarde die is doorgegeven, de method parameter ingesteld op null, de headers parameter ingesteld op nullen de preserveUser parameter ingesteld op true. Zie de sectie 'Opmerkingen' in TransferRequest(String, Boolean, String, NameValueCollection)voor meer informatie.

TransferRequest wordt geïntroduceerd in de .NET Framework versie 3.5. Zie Versies en afhankelijkheden voor meer informatie.

TransferRequest(String, Boolean, String, NameValueCollection)

Voert een asynchrone uitvoering van de opgegeven URL uit met behulp van de opgegeven HTTP-methode en headers.

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)

Parameters

path

String

Het URL-pad van de nieuwe pagina op de server die moet worden uitgevoerd.

preserveForm

Boolean

true om de Form verzameling te behouden; false om de Form verzameling te wissen.

method

String

De HTTP-methode die moet worden gebruikt bij de uitvoering van de nieuwe aanvraag.

headers

NameValueCollection

Een NameValueCollection van aanvraagheaders voor de nieuwe aanvraag.

Uitzonderingen

PlatformNotSupportedException

Voor de aanvraag is IIS 7.0 vereist die in de geïntegreerde modus wordt uitgevoerd.

HttpException

De server is niet beschikbaar om de aanvraag te verwerken.

ArgumentNullException

De path parameter is null.

ArgumentException

De path parameter is ongeldig.

Opmerkingen

Deze methode wordt gebruikt bij uitvoering met de geïntegreerde pijplijnmodus in IIS 7.0, zodat aanvraagverwerking van het ene resourcetype naar het andere kan worden overgebracht terwijl de doelaanvraag wordt uitgevoerd met de juiste aanvraagcontext. U kunt bijvoorbeeld de TransferRequest methode gebruiken om een aanvraag voor een ASPX-pagina over te dragen naar een aanvraag voor een XML-pagina.

De TransferRequest methode voert een asynchrone onderliggende uitvoering van de opgegeven URL uit met de volgende voorwaarden:

• Als de path parameter een queryreeks opgeeft, wordt deze gebruikt als de nieuwe querytekenreeks. Als er geen querytekenreeks is opgenomen, wordt de queryreeks van de aanvraag opnieuw gebruikt.

• Als de method parameter is opgegeven, wordt deze gebruikt. Als dit het is null, wordt de HTTP-methode van de oorspronkelijke aanvraag gebruikt.

• Als de preserveForm parameter is true, is de huidige entiteitsbody van de aanvraag beschikbaar voor de doelaanvraag. Hierdoor kunnen formulierposts en uploads worden overgedragen.

• Als de gebruikersidentiteit momenteel is ingesteld op de oorspronkelijke aanvraag, wordt de identiteit overgedragen naar de nieuwe aanvraag. Hierdoor kunnen geverifieerde aanvragen het resultaat van de verificatie voor de nieuwe aanvraag opnieuw gebruiken. Als u niet wilt dat de gebruiker wordt overgedragen, stelt u de gebruiker null in op de oorspronkelijke aanvraag voordat u de overdracht uitvoert.

• Als de headers parameter is opgegeven, wordt de nieuwe aanvraag uitgevoerd met de opgegeven headers. Dit kan worden gebruikt om de aanvraagheaders en cookies voor de nieuwe aanvraag te wijzigen of voeg een speciale header toe die aangeeft waar de oorspronkelijke aanvraag is ontvangen.

  Met deze methode wordt de overbelasting van de TransferRequest(String, Boolean, String, NameValueCollection, Boolean) methode aangeroepen met de preserveUser parameter die is ingesteld op true.

TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

Voert een asynchrone uitvoering van de opgegeven URL uit met behulp van de opgegeven HTTP-methode, headers en pad, en behoudt eventueel formulierwaarden en de gebruikersidentiteit.

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)

Parameters

path

String

Het pad.

preserveForm

Boolean

true om de Form verzameling te behouden; false om de Form verzameling te wissen.

method

String

De HTTP-methode die moet worden gebruikt in de nieuwe aanvraag.

headers

NameValueCollection

Een NameValueCollection object met aanvraagheaders voor de nieuwe aanvraag.

preserveUser

Boolean

true om de gebruikersidentiteit te behouden; anders, false. De andere methode-overbelastingen van deze methode roepen deze overbelasting aan met deze parameter ingesteld op true.

Uitzonderingen

PlatformNotSupportedException

Voor de aanvraag is de geïntegreerde pijplijnmodus van IIS 7.0 vereist.

HttpException

De server is niet beschikbaar om de aanvraag te verwerken.

ArgumentNullException

De path parameter is null.

ArgumentException

De path parameter is ongeldig.

Opmerkingen

Zie de sectie 'Opmerkingen' in TransferRequest(String, Boolean, String, NameValueCollection)voor meer informatie.