ScriptManager.RegisterDispose(Control, String) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
dispose Egy vezérlőn belüli vezérlőelem szkriptjének regisztrálásaUpdatePanel. A szkript a vezérlő frissítésekor vagy törlésekor UpdatePanel lesz végrehajtva.
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)Paraméterek
- control
- Control
A parancsprogram vezérlője dispose .
- disposeScript
- String
A dispose szkript.
Kivételek
Megjegyzések
A metódus használatával RegisterDispose szkripteket regisztrálhat dispose egy vezérlőn belüli UpdatePanel vezérlőkhöz. Az aszinkron visszavételek során a vezérlők frissíthetők, UpdatePanel törölhetők vagy létrehozhatók. A panel frissítésekor vagy törlésekor a rendszer meghívja azokat dispose a szkripteket, amelyek regisztrálva vannak a UpdatePanel vezérlőkhöz. A tipikus lapfejlesztési forgatókönyvekben nem kell meghívnia a metódust RegisterDispose .
A RegisterDispose metódust a vezérlőfejlesztők arra használják, hogy szkripteket regisztráljanak, vagy olyan vezérlőket hozzanak létre, amelyek öröklődnek a IScriptControl felületről. Használhat például egy szkriptet dispose , ha az ügyfélvezérlőt összeállítással fejleszti ki. A vezérlőben egyéni vezérlőket valósíthat meg IScriptControl és jeleníthet meg. Minden olyan elem metódusát regisztrálja dispose , amely nem felel meg egy meghatározott ügyfélösszetevőnek, például Sys.TextBox. Ha az egyéni vezérlő az Ajax-kódtár Microsoft ügyfélösszetevőinek megfelelő elemeket alkot, nem kell regisztrálnia egy dispose szkriptet, mert a dispose automatikusan meghívja. Ezért használja a RegisterDispose metódust az olyan ügyfélösszetevőkhöz, amelyek az Microsoft Ajax-kódtár részét képezik, és amelyeknek erőforrásokat kell felszabadítania, amikor már nem használnak összetevőt.
A RegisterDispose metódus többször is meghívható vezérlőelemekhez. A rendszer több szkriptet összesít. A szkriptek törlési sorrendje megegyezik a szkriptek regisztrálásának sorrendjével.
Ha olyan vezérlőelemhez regisztrál dispose szkriptet, amely nincs vezérlőben UpdatePanel , kivételt jelez. A dispose szkript az osztály és pageLoading az pageLoadedPageRequestManager események között van meghívva.
