ScriptManager.RegisterDispose(Control, String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Registreert een dispose script voor een besturingselement dat zich in een UpdatePanel besturingselement bevindt. Het script wordt uitgevoerd wanneer het UpdatePanel besturingselement wordt bijgewerkt of verwijderd.
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)Parameters
- control
- Control
Het besturingselement waarvoor het dispose script is bedoeld.
- disposeScript
- String
Het dispose script.
Uitzonderingen
control is niet gevonden op de pagina.
– of –
control bevindt zich niet in een UpdatePanel besturingselement.
Opmerkingen
Gebruik de RegisterDispose methode om scripts te registreren dispose voor besturingselementen die zich in een UpdatePanel besturingselement bevinden. Tijdens asynchrone postbacks UpdatePanel kunnen besturingselementen worden bijgewerkt, verwijderd of gemaakt. Wanneer een paneel wordt bijgewerkt of verwijderd, worden alle scripts die zijn geregistreerd voor besturingselementen die zich in het dispose deelvenster bevinden, UpdatePanel aangeroepen. In typische scenario's voor paginaontwikkeling hoeft u de RegisterDispose methode niet aan te roepen.
De RegisterDispose methode is bedoeld voor gebruik door besturingselementontwikkelaars om een script te registreren of besturingselementen te maken die overnemen van de IScriptControl interface. U kunt bijvoorbeeld een dispose script gebruiken als u een clientbeheer ontwikkelt met behulp van samenstelling. In uw besturingselement implementeert IScriptControl en geeft u afzonderlijke besturingselementen weer. U registreert de dispose methode van een item dat niet overeenkomt met een gedefinieerd clientonderdeel, zoals Sys.TextBox. Als uw aangepaste besturingselement elementen samenstelt die overeenkomen met clientonderdelen in de Microsoft Ajax-bibliotheek, hoeft u geen dispose script te registreren, omdat dispose automatisch wordt aangeroepen. Gebruik daarom de methode RegisterDispose voor clientonderdelen die deel uitmaken van de Microsoft Ajax-bibliotheek en die resources moeten vrij maken wanneer een onderdeel niet meer wordt gebruikt.
De RegisterDispose methode kan meerdere keren worden aangeroepen voor een besturingselement. Er worden meerdere scripts samengevoegd. De volgorde van het verwijderen van scripts komt overeen met de volgorde waarin de scripts zijn geregistreerd.
Als u een dispose script registreert voor een besturingselement dat zich niet in een UpdatePanel besturingselement bevindt, wordt er een uitzondering gegenereerd. Het dispose script wordt aangeroepen tussen de pageLoading en pageLoaded gebeurtenissen van de PageRequestManager klasse.
