HttpServerUtility.TransferRequest Yöntem

Tanım

Ad Alanı:: System.Web

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

Aşırı Yüklemeler

Name	Description
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ütülmesini 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ütülmesini 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. Versions and Dependencies.

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 sunucudaki yeni sayfanın URL yolu.

Özel durumlar

PlatformNotSupportedException

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

HttpException

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

ArgumentNullException

path parametresi null'dir.

ArgumentException

path parametresi geçersiz.

Açıklamalar

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

Şunlara uygulanır

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 sunucudaki 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 tümleşik işlem hattı modunu gerektirir.

HttpException

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

ArgumentNullException

path parametresi null'dir.

ArgumentException

path parametresi geçersiz.

Açıklamalar

Bu aşırı yükleme, geçirilen değere ayarlanmış parametre, method parametresi olarak ayarlanmış, headers parametresi olarak ayarlanmış nullnullve 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.

Şunlara uygulanır

TransferRequest(String, Boolean, String, NameValueCollection)

Belirtilen HTTP yöntemini ve üst bilgilerini kullanarak belirtilen URL'nin zaman uyumsuz yürütülmesini 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 sunucudaki 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ılamaz.

ArgumentNullException

path parametresi null'dir.

ArgumentException

path parametresi 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, bir ASPX sayfası isteğini XML sayfası isteğine aktarmak için yöntemini kullanabilirsiniz TransferRequest .

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 dahil edilmediyse, 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ına olanak tanır.
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 isteğ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 preserveUsertrueçağırırTransferRequest(String, Boolean, String, NameValueCollection, Boolean).

Şunlara uygulanır

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

Belirtilen HTTP yöntemini, üst bilgileri ve yolu kullanarak belirtilen URL'nin zaman uyumsuz yürütülmesini 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 bilgileri 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 tümleşik işlem hattı modunu gerektirir.

HttpException

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

ArgumentNullException

path parametresi null'dir.

ArgumentException

path parametresi geçersiz.

Açıklamalar

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

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?