ScriptManager.RegisterDispose(Control, String) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Registrerar ett dispose skript för en kontroll som finns i en UpdatePanel kontroll. Skriptet körs när UpdatePanel kontrollen uppdateras eller tas bort.
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)Parametrar
- control
- Control
Den kontroll som skriptet dispose är till för.
- disposeScript
- String
Skriptet dispose .
Undantag
Kommentarer
RegisterDispose Använd metoden för att registrera dispose skript för kontroller som finns i en UpdatePanel kontroll. Under asynkrona postbacks UpdatePanel kan kontroller uppdateras, tas bort eller skapas. När en panel uppdateras eller tas bort anropas alla dispose skript som är registrerade för kontroller som finns i den UpdatePanel . I vanliga scenarier för sidutveckling behöver du inte anropa RegisterDispose metoden.
Metoden RegisterDispose är avsedd att användas av kontrollutvecklare för att registrera skript eller skapa kontroller som ärver från IScriptControl gränssnittet. Du kan till exempel använda ett dispose skript om du utvecklar en klientkontroll med hjälp av komposition. I din kontroll implementerar IScriptControl och renderar du enskilda kontroller. Du registrerar metoden för dispose alla objekt som inte motsvarar en definierad klientkomponent, till exempel Sys.TextBox. Om din anpassade kontroll består av element som motsvarar klientkomponenter i Microsoft Ajax-biblioteket behöver du inte registrera ett dispose skript eftersom dispose anropas automatiskt. Använd därför metoden RegisterDispose för klientkomponenter som ingår i Microsoft Ajax-biblioteket och som måste frigöra resurser när en komponent inte längre används.
Metoden RegisterDispose kan anropas flera gånger för en kontroll. Flera skript aggregeras. Ordningen för att ta bort skript matchar den ordning i vilken skripten registrerades.
Om du registrerar ett dispose skript för en kontroll som inte finns i en UpdatePanel kontroll genereras ett undantag. Skriptet dispose anropas mellan pageLoading klassens pageLoaded händelser och PageRequestManager .
