HttpServerUtility.TransferRequest Yöntem

Tanım

Ad Alanı:

System.Web

Bütünleştirilmiş Kod:

System.Web.dll

Belirtilen URL'nin zaman uyumsuz yürütmesini gerçekleştirir.

Aşırı Yüklemeler

TransferRequest(String)	Belirtilen URL'nin zaman uyumsuz yürütmesini gerçekleştirir.
TransferRequest(String, Boolean)	Belirtilen URL'nin zaman uyumsuz yürütmesini gerçekleştirir ve sorgu dizesi parametrelerini korur.
TransferRequest(String, Boolean, String, NameValueCollection)	Belirtilen HTTP yöntemini ve üst bilgilerini kullanarak belirtilen URL'nin zaman uyumsuz yürütmesini gerçekleştirir.
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	Belirtilen HTTP yöntemini, üst bilgileri ve yolu kullanarak belirtilen URL'nin zaman uyumsuz yürütmesini gerçekleştirir ve isteğe bağlı olarak form değerlerini ve kullanıcı kimliğini korur.

Açıklamalar

TransferRequest.NET Framework sürüm 3.5'te kullanıma sunulmuştur. .NET Framework hakkında özet bilgi için bkz. Sürümler ve Bağımlılıklar.

TransferRequest(String)

Belirtilen URL'nin zaman uyumsuz yürütmesini gerçekleştirir.

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

public void TransferRequest (string path);

member this.TransferRequest : string -> unit

Public Sub TransferRequest (path As String)

Parametreler

path

String

Yürütülecek sunucuda yeni sayfanın URL yolu.

Özel durumlar

PlatformNotSupportedException

İstek, IIS 7.0'ın tümleşik işlem hattı modunu gerektirir.

HttpException

Sunucu, isteği işlemek için kullanılamıyor.

ArgumentNullException

path parametresidirnull.

ArgumentException

path Parametre geçersiz.

Açıklamalar

Bu yöntem aşırı yüklemesi, parametresi olarak ayarlanmış parametresi, parametresi olarak ayarlanmış nullparametresi headers ve preserveUser parametresi olarak ayarlanmış true``nullolan aşırı yüklemeyi preserveForm çağırırTransferRequest.method false Daha fazla bilgi için aşırı yüklemedeki "Açıklamalar" bölümüne TransferRequest(String, Boolean, String, NameValueCollection) bakın.

TransferRequest(String, Boolean)

Belirtilen URL'nin zaman uyumsuz yürütmesini gerçekleştirir ve sorgu dizesi parametrelerini korur.

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)

Parametreler

path

String

Yürütülecek sunucuda yeni sayfanın URL yolu.

preserveForm

Boolean

true koleksiyonu korumak Form için; false koleksiyonu temizlemek Form için.

Özel durumlar

PlatformNotSupportedException

İstek, IIS 7.0'ın tümleşik işlem hattı modunu gerektirir.

HttpException

Sunucu, isteği işlemek için kullanılamıyor.

ArgumentNullException

path parametresidirnull.

ArgumentException

path Parametre geçersiz.

Açıklamalar

Bu aşırı yükleme, parametresi geçirilen değere ayarlanmış, method parametresi olarak ayarlanmış, headers parametresi olarak ayarlanmış null``nullve preserveUser parametresi olarak ayarlanmış trueolan aşırı yüklemeyi preserveForm çağırırTransferRequest. Daha fazla bilgi için içindeki "Açıklamalar" bölümüne TransferRequest(String, Boolean, String, NameValueCollection)bakın.

TransferRequest.NET Framework sürüm 3.5'te kullanıma sunulmuştur. Daha fazla bilgi için bkz . Sürümler ve Bağımlılıklar.

TransferRequest(String, Boolean, String, NameValueCollection)

Belirtilen HTTP yöntemini ve üst bilgilerini kullanarak belirtilen URL'nin zaman uyumsuz yürütmesini gerçekleştirir.

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)

Parametreler

path

String

Yürütülecek sunucuda yeni sayfanın URL yolu.

preserveForm

Boolean

true koleksiyonu korumak Form için; false koleksiyonu temizlemek Form için.

method

String

Yeni isteğin yürütülmesinde kullanılacak HTTP yöntemi.

headers

NameValueCollection

NameValueCollection Yeni istek için istek üst bilgilerinden biri.

Özel durumlar

PlatformNotSupportedException

İstek, IIS 7.0'ın tümleşik modda çalışmasını gerektirir.

HttpException

Sunucu isteği işlemek için kullanılamıyor.

ArgumentNullException

path parametresidirnull.

ArgumentException

path Parametre geçersiz.

Açıklamalar

Bu yöntem IIS 7.0'da tümleşik işlem hattı moduyla çalıştırılırken, hedef isteği doğru istek bağlamıyla yürütürken istek işlemenin bir kaynak türünden diğerine aktarılmasına izin vermek için kullanılır. Örneğin, aspx sayfasına yönelik TransferRequest bir isteği XML sayfası isteğine aktarmak için yöntemini kullanabilirsiniz.

yöntemi, TransferRequest aşağıdaki koşullarla belirtilen URL'nin zaman uyumsuz alt yürütmesini gerçekleştirir:

• path parametresi bir sorgu dizesi belirtirse, yeni sorgu dizesi olarak kullanılır. Hiçbir sorgu dizesi eklenmediyse isteğin sorgu dizesi yeniden kullanılır.

• method parametresi belirtilirse kullanılır. ise null, özgün isteğin HTTP yöntemi kullanılır.

• preserveForm parametresi isetrue, isteğin geçerli varlık gövdesi hedef isteğin kullanımına sunulur. Bu, form gönderilerinin ve karşıya yüklemelerin aktarılmasını sağlar.

• Kullanıcı kimliği şu anda özgün istekte ayarlanmışsa, kimlik yeni isteğe aktarılır. Bu, kimliği doğrulanmış isteklerin yeni istek için kimlik doğrulamasının sonucunu yeniden kullanmasına olanak tanır. Kullanıcının aktarılmasını istemiyorsanız, aktarmadan önce kullanıcıyı null özgün istekte olarak ayarlayın.

• headers Parametresi belirtilirse, yeni istek belirtilen üst bilgilerle yürütülür. Bu, yeni istek için istek üst bilgilerini ve tanımlama bilgilerini değiştirmek veya özgün isteğin nereden alındığını belirten özel bir üst bilgi eklemek için kullanılabilir.

  Bu yöntem, parametresi olarak ayarlanmış yöntem aşırı yüklemesini preserveUser trueçağırırTransferRequest(String, Boolean, String, NameValueCollection, Boolean).

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

Belirtilen HTTP yöntemini, üst bilgileri ve yolu kullanarak belirtilen URL'nin zaman uyumsuz yürütmesini gerçekleştirir ve isteğe bağlı olarak form değerlerini ve kullanıcı kimliğini korur.

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)

Parametreler

path

String

Yol.

preserveForm

Boolean

true koleksiyonu korumak Form için; false koleksiyonu temizlemek Form için.

method

String

Yeni istekte kullanılacak HTTP yöntemi.

headers

NameValueCollection

NameValueCollection Yeni istek için istek üst bilgilerini içeren bir nesne.

preserveUser

Boolean

true kullanıcı kimliğini korumak için; aksi takdirde , false. Bu yöntemin diğer yöntem aşırı yüklemeleri, bu parametre olarak ayarlanmış truebu aşırı yüklemeyi çağırır.

Özel durumlar

PlatformNotSupportedException

İstek, IIS 7.0'ın tümleşik işlem hattı modunu gerektirir.

HttpException

Sunucu isteği işlemek için kullanılamıyor.

ArgumentNullException

path parametresidirnull.

ArgumentException

path Parametre geçersiz.

Açıklamalar

Daha fazla bilgi için içindeki "Açıklamalar" bölümüne TransferRequest(String, Boolean, String, NameValueCollection)bakın.