ScriptManager.RegisterDispose(Control, String) Yöntem

Tanım

Denetimin dispose içindeki UpdatePanel bir denetim için betik kaydeder. Denetim güncelleştirildiğinde veya silindiğinde UpdatePanel betik yürütülür.

public:
 void RegisterDispose(System::Web::UI::Control ^ control, System::String ^ disposeScript);
public void RegisterDispose(System.Web.UI.Control control, string disposeScript);
member this.RegisterDispose : System.Web.UI.Control * string -> unit
Public Sub RegisterDispose (control As Control, disposeScript As String)

Parametreler

control
Control

Betiğin dispose için olduğu denetim.

disposeScript
String

Betik dispose .

Özel durumlar

control, null'e eşittir.

-veya-

disposeScript, null'e eşittir.

control sayfada bulunamadı.

-veya-

control bir UpdatePanel denetimin içinde değil.

Açıklamalar

Bir denetimin RegisterDispose içindeki dispose denetimler için betikleri kaydetmek UpdatePanel için yöntemini kullanın. Zaman uyumsuz geri göndermeler sırasında denetimler UpdatePanel güncelleştirilebilir, silinebilir veya oluşturulabilir. Bir panel güncelleştirildiğinde veya silindiğinde içindeki denetimler dispose için kaydedilen tüm UpdatePanel betikler çağrılır. Tipik sayfa geliştirme senaryolarında yöntemini çağırmanız RegisterDispose gerekmez.

RegisterDispose yöntemi, denetim geliştiricileri tarafından betiği kaydetmek veya arabirimden IScriptControl devralan denetimler oluşturmak için tasarlanmıştır. Örneğin, oluşturma kullanarak bir dispose istemci denetimi geliştirirseniz bir betik kullanabilirsiniz. Denetiminizde tek tek denetimleri uygular IScriptControl ve işlersiniz. gibi disposetanımlı bir istemci bileşenine karşılık olmayan herhangi bir öğenin yöntemini kaydedersinizSys.TextBox. Özel denetiminiz Microsoft Ajax Kitaplığı'ndaki istemci bileşenlerine karşılık gelen öğeler oluşturuyorsa, dispose otomatik olarak çağrıldığından dispose betiğini kaydetmeniz gerekmez. Bu nedenle, Microsoft Ajax Kitaplığı'nın parçası olan ve bir bileşen artık kullanılmadığında kaynakları boşaltması gereken istemci bileşenleri için RegisterDispose yöntemini kullanın.

RegisterDispose Yöntemi bir denetim için birden çok kez çağrılabilir. Birden çok betik toplanır. Betikleri yok etme sırası, betiklerin kaydedildiği sırayla eşleşir.

Denetimde dispose olmayan bir UpdatePanel denetim için betik kaydederseniz, bir özel durum oluşturulur. Betikdispose, sınıfının ve pageLoading olayları arasında pageLoaded çağrılırPageRequestManager.

Şunlara uygulanır

Ayrıca bkz.