ScriptManager.RegisterDispose(Control, String) Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.Extensions.dll

Zaregistruje dispose skript pro ovládací prvek, který je uvnitř UpdatePanel ovládacího prvku. Skript se spustí při UpdatePanel aktualizaci nebo odstranění ovládacího prvku.

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)

Parametry

control

Control

Ovládací prvek, pro který dispose je skript určený.

disposeScript

String

Skript dispose .

Výjimky

ArgumentNullException

control je null.

-nebo- disposeScript je null.

ArgumentException

control na stránce nebyl nalezen.

-nebo- control není uvnitř UpdatePanel ovládacího prvku.

Poznámky

RegisterDispose Pomocí metody zaregistrujte dispose skripty pro ovládací prvky, které jsou uvnitř UpdatePanel ovládacího prvku. Během asynchronních postbacků UpdatePanel je možné ovládací prvky aktualizovat, odstranit nebo vytvořit. Při aktualizaci nebo odstranění panelu se volají všechny dispose skripty zaregistrované pro ovládací prvky, které jsou uvnitř daného panelu UpdatePanel . V typických scénářích vývoje stránek nemusíte metodu RegisterDispose volat.

Metoda RegisterDispose je určena pro vývojáře řízení k registraci skriptu nebo vytvoření ovládacích prvků, které dědí z IScriptControl rozhraní. Pokud například vyvíjíte ovládací prvek klienta pomocí složení, můžete použít dispose skript. V ovládacím prvku implementujete IScriptControl a vykreslujete jednotlivé ovládací prvky. Zaregistrujete metodu dispose jakékoli položky, která neodpovídá definované klientské komponentě, například Sys.TextBox. Pokud vlastní ovládací prvek skládá prvky, které odpovídají klientským komponentám v knihovně Microsoft Ajax Library, nemusíte registrovat dispose skript, protože dispose se volá automaticky. Proto použijte metodu RegisterDispose pro klientské komponenty, které jsou součástí knihovny Microsoft Ajax a které musí uvolnit prostředky, pokud se komponenta už nepoužívá.

Metodu RegisterDispose lze volat vícekrát pro ovládací prvek. Agregují se více skriptů. Pořadí odkládání skriptů odpovídá pořadí, ve kterém byly skripty zaregistrovány.

Pokud zaregistrujete dispose skript pro ovládací prvek, který není v ovládacím UpdatePanel prvku, vyvolá se výjimka. Skript dispose je volána mezi pageLoading a pageLoaded událostmi PageRequestManager třídy.

Viz také

• IScriptControl