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 -> unitPublic 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
Poznámky
RegisterDispose Tato metoda slouží k registraci dispose skriptů pro ovládací prvky, které jsou uvnitř UpdatePanel ovládacího prvku. Během asynchronních postbacků UpdatePanel lze 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čená pro vývojáře ovládacích prvků k registraci skriptu nebo vytvoření ovládacích prvků, které dědí z IScriptControl rozhraní. Pokud například vyvíjíte klientský ovládací prvek pomocí složení, můžete použít dispose skript. V ovládacím prvku implementujete IScriptControl a vykreslujete jednotlivé ovládací prvky. Zaregistrujete dispose metodu jakékoli položky, která neodpovídá definované klientské komponentě, například Sys.TextBox. Pokud vlastní ovládací prvek kompozuje prvky, které odpovídají klientským komponentám v Microsoft Ajax Library, nemusíte registrovat skript dispose, 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í odsazení 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.
