HttpServerUtility.Transfer Yöntem

Tanım

Ad Alanı:

System.Web

Bütünleştirilmiş Kod:

System.Web.dll

Geçerli sayfanın yürütülmesini sonlandırır ve geçerli istek için yeni bir sayfanın yürütülmesini başlatır.

Aşırı Yüklemeler

Transfer(String)	Geçerli istek için geçerli sayfanın yürütülmesini sonlandırır ve sayfanın belirtilen URL yolunu kullanarak yeni bir sayfanın yürütülmesini başlatır.
Transfer(String, Boolean)	Geçerli sayfanın yürütülmesini sonlandırır ve sayfanın belirtilen URL yolunu kullanarak yeni bir sayfanın yürütülmesini başlatır. ve Form koleksiyonlarının temizlenip temizlenmeyeceğini QueryString belirtir.
Transfer(IHttpHandler, Boolean)	Geçerli sayfanın yürütülmesini sonlandırır ve arabirimini uygulayan IHttpHandler ve ve Form koleksiyonlarının temizlenip temizlenmeyeceğini belirten özel bir HTTP işleyicisi kullanarak yeni bir isteğin yürütülmesini QueryString başlatır.

Transfer(String)

Geçerli istek için geçerli sayfanın yürütülmesini sonlandırır ve sayfanın belirtilen URL yolunu kullanarak yeni bir sayfanın yürütülmesini başlatır.

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

public void Transfer (string path);

member this.Transfer : string -> unit

Public Sub Transfer (path As String)

Parametreler

path

String

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

Açıklamalar

aktarıldığı sayfa başka bir .aspx sayfası olmalıdır. Örneğin, bir .asp veya .asmx sayfasına aktarım geçerli değildir. Transfer yöntemi ve Form koleksiyonlarını QueryString korur.

Transfer, tamamlandıktan sonra bir ThreadAbortException özel durum oluşturan öğesini çağırırEnd.

ASP.NET, geçerli kullanıcının yöntemi tarafından Transfer teslim edilen kaynağı görüntüleme yetkisine sahip olduğunu doğrulamaz. ASP.NET yetkilendirme ve kimlik doğrulama mantığı özgün kaynak işleyici çağrılmadan önce çalıştırılsa da, ASP.NET doğrudan yöntemi tarafından belirtilen işleyiciyi Transfer çağırır ve yeni kaynak için kimlik doğrulama ve yetkilendirme mantığını yeniden çalıştırmaz. Uygulamanızın güvenlik ilkesi istemcilerin kaynağa erişmek için uygun yetkilendirmeye sahip olmasını gerektiriyorsa, uygulamanın yeniden kimlik doğrulamaya zorlaması veya özel bir erişim denetimi mekanizması sağlaması gerekir.

yöntemi yerine yöntemini kullanarak Redirect yeniden yetkilendirmeye Transfer zorlayabilirsiniz. yöntemi, Redirect tarayıcının yeni kaynağı istediği bir istemci tarafı yeniden yönlendirmesi gerçekleştirir. Bu yeniden yönlendirme sisteme giren yeni bir istek olduğundan, hem Internet Information Services (IIS) hem de ASP.NET güvenlik ilkesinin tüm kimlik doğrulama ve yetkilendirme mantığına tabidir.

Uygulamanın yöntemini çağırmadan önce yöntemini kullanan IsInRole özel bir yetkilendirme yöntemi ekleyerek kullanıcının kaynağı görüntüleme iznine Transfer sahip olduğunu doğrulayabilirsiniz.

Transfer(String, Boolean)

Geçerli sayfanın yürütülmesini sonlandırır ve sayfanın belirtilen URL yolunu kullanarak yeni bir sayfanın yürütülmesini başlatır. ve Form koleksiyonlarının temizlenip temizlenmeyeceğini QueryString belirtir.

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)

Parametreler

path

String

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

preserveForm

Boolean

trueve Form koleksiyonlarını QueryString korumak; false ve Form koleksiyonlarını QueryString temizlemek için.

Özel durumlar

ApplicationException

Geçerli sayfa isteği bir geri aramadır.

Örnekler

Aşağıdaki örnek, geçerli sayfayla aynı dizinde yeni bir sayfa yürütür.

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

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

Açıklamalar

aktarıldığı sayfa başka bir .aspx sayfası olmalıdır. Örneğin, bir .asp veya .asmx sayfasına aktarım geçerli değildir.

Transfer, tamamlandıktan sonra bir ThreadAbortException özel durum oluşturan öğesini çağırırEnd.

parametresini preserveFormtrueolarak ayarlarsanız, hedef sayfa özelliğini kullanarak PreviousPage önceki sayfanın görünüm durumuna erişebilir.

Güvenlik amacıyla özniteliğini enableViewStateMac olarak trueayarlamanız gerekir. ASP.NET, geçerli kullanıcının yöntemi tarafından Transfer teslim edilen kaynağı görüntüleme yetkisine sahip olduğunu doğrulamaz. ASP.NET yetkilendirme ve kimlik doğrulama mantığı özgün kaynak işleyici çağrılmadan önce çalıştırılsa da, ASP.NET doğrudan yöntemi tarafından belirtilen işleyiciyi Transfer çağırır ve yeni kaynak için kimlik doğrulama ve yetkilendirme mantığını yeniden çalıştırmaz. Uygulamanızın güvenlik ilkesi istemcilerin kaynağa erişmek için uygun yetkilendirmeye sahip olmasını gerektiriyorsa, uygulamanın yeniden kimlik doğrulamaya zorlaması veya özel bir erişim denetimi mekanizması sağlaması gerekir.

yöntemi yerine yöntemini kullanarak Redirect yeniden yetkilendirmeye Transfer zorlayabilirsiniz. yöntemi, Redirect tarayıcının yeni kaynağı istediği bir istemci tarafı yeniden yönlendirmesi gerçekleştirir. Bu yeniden yönlendirme sisteme giren yeni bir istek olduğundan, hem Internet Information Services (IIS) hem de ASP.NET güvenlik ilkesinin tüm kimlik doğrulama ve yetkilendirme mantığına tabidir.

Uygulamanın yöntemini çağırmadan önce yöntemini kullanan IsInRole özel bir yetkilendirme yöntemi ekleyerek kullanıcının kaynağı görüntüleme iznine Transfer sahip olduğunu doğrulayabilirsiniz.

Transfer(IHttpHandler, Boolean)

Geçerli sayfanın yürütülmesini sonlandırır ve arabirimini uygulayan IHttpHandler ve ve Form koleksiyonlarının temizlenip temizlenmeyeceğini belirten özel bir HTTP işleyicisi kullanarak yeni bir isteğin yürütülmesini QueryString başlatır.

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)

Parametreler

handler

IHttpHandler

Geçerli isteğin aktarıldığını uygulayan IHttpHandler HTTP işleyicisi.

preserveForm

Boolean

trueve Form koleksiyonlarını QueryString korumak; false ve Form koleksiyonlarını QueryString temizlemek için.

Özel durumlar

ApplicationException

Geçerli sayfa isteği bir geri aramadır.

Açıklamalar

Ortak Dil Belirtimi (CLS) ile uyumlu herhangi bir dilde belirli, önceden tanımlanmış HTTP isteği türlerini işlemek için özel HTTP işleyicileri yazabilirsiniz. Geleneksel ASP (klasik ASP olarak da bilinir) sayfaları veya ASP.NET sayfaları yerine HTTP işleyici sınıflarında tanımlanan yürütülebilir kod bu isteklere yanıt verir. HTTP işleyicileri, Internet Information Services (IIS) çalıştıran bir Web sunucusunun alt düzey istek ve yanıt hizmetleriyle etkileşime olanak tanır ve ISAPI uzantılarına benzer ancak daha basit bir programlama modeliyle işlevsellik sağlar.

parametresini preserveFormtrueolarak ayarlarsanız, hedef sayfa özelliğini kullanarak PreviousPage önceki sayfanın görünüm durumuna erişebilir.

Güvenlik amacıyla özniteliğini enableViewStateMac olarak trueayarlamanız gerekir. ASP.NET, geçerli kullanıcının yöntemi tarafından Transfer teslim edilen kaynağı görüntüleme yetkisine sahip olduğunu doğrulamaz. ASP.NET yetkilendirme ve kimlik doğrulama mantığı özgün kaynak işleyici çağrılmadan önce çalıştırılsa da, ASP.NET doğrudan yöntemi tarafından belirtilen işleyiciyi Transfer çağırır ve yeni kaynak için kimlik doğrulama ve yetkilendirme mantığını yeniden çalıştırmaz. Uygulamanızın güvenlik ilkesi istemcilerin kaynağa erişmek için uygun yetkilendirmeye sahip olmasını gerektiriyorsa, uygulamanın yeniden kimlik doğrulamaya zorlaması veya özel bir erişim denetimi mekanizması sağlaması gerekir.

yöntemi yerine yöntemini kullanarak Redirect yeniden yetkilendirmeye Transfer zorlayabilirsiniz. yöntemi, Redirect tarayıcının yeni kaynağı istediği bir istemci tarafı yeniden yönlendirmesi gerçekleştirir. Bu yeniden yönlendirme sisteme giren yeni bir istek olduğundan, hem IIS hem de ASP.NET güvenlik ilkesinin tüm kimlik doğrulama ve yetkilendirme mantığına tabidir.

Uygulamanın yöntemini çağırmadan önce yöntemini kullanan IsInRole özel bir yetkilendirme yöntemi ekleyerek kullanıcının kaynağı görüntüleme iznine Transfer sahip olduğunu doğrulayabilirsiniz.