ScriptManager.RegisterDispose(Control, String) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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.