ScriptManager.RegisterStartupScript Methode

Definitie

Naamruimte:
System.Web.UI
Assembly:
System.Web.Extensions.dll

Registreert een opstartscriptblok met het ScriptManager besturingselement en voegt het scriptblok toe aan de pagina.

Overloads

Name Description
RegisterStartupScript(Control, Type, String, String, Boolean)

Registreert een opstartscriptblok voor een besturingselement dat zich in een UpdatePanel besturingselement bevindt met behulp van het ScriptManager besturingselement en voegt het scriptblok toe aan de pagina.
RegisterStartupScript(Page, Type, String, String, Boolean)

Registreert een opstartscriptblok voor elke asynchrone postback met het ScriptManager besturingselement en voegt het scriptblok toe aan de pagina.

RegisterStartupScript(Control, Type, String, String, Boolean)

Registreert een opstartscriptblok voor een besturingselement dat zich in een UpdatePanel besturingselement bevindt met behulp van het ScriptManager besturingselement en voegt het scriptblok toe aan de pagina.

public:
 static void RegisterStartupScript(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);
public static void RegisterStartupScript(System.Web.UI.Control control, Type type, string key, string script, bool addScriptTags);
static member RegisterStartupScript : System.Web.UI.Control * Type * string * string * bool -> unit
Public Shared Sub RegisterStartupScript (control As Control, type As Type, key As String, script As String, addScriptTags As Boolean)

Parameters

control
Control

Het besturingselement dat het clientscriptblok registreert.

type
Type

Het type clientscriptblok. Deze parameter wordt meestal opgegeven met behulp van de typeof-operator (C#) of de GetType-operator (Visual Basic) om het type besturingselement op te halen dat het script registreert.

key
String

Een unieke id voor het scriptblok.

script
String

Het script dat moet worden geregistreerd.

addScriptTags
Boolean

trueom het scriptblok met <script> en </script> tags in te sluiten; anders. false

Uitzonderingen

ArgumentNullException

control is null.

– of –

type is null.

ArgumentException

control bevindt zich niet in de besturingsstructuur van de pagina.

Opmerkingen

U gebruikt de methode RegisterStartupScript om een opstartscriptblok te registreren voor een pagina die compatibel is met gedeeltelijke paginaweergave en die geen Microsoft Ajax-bibliotheekafhankelijkheden heeft. Opstartscriptblokken die zijn geregistreerd met deze methode, worden alleen naar de pagina verzonden wanneer het besturingselement dat het blok registreert zich in een UpdatePanel besturingselement bevindt dat wordt bijgewerkt. Als u een opstartscriptblok wilt registreren telkens wanneer een asynchrone postback optreedt, gebruikt u de RegisterStartupScript(Page, Type, String, String, Boolean) overbelasting van deze methode.

Als u een opstartscript wilt registreren dat niet betrekking heeft op updates van gedeeltelijke pagina's en als u het script slechts één keer wilt registreren tijdens de eerste paginaweergave, gebruikt u de RegisterStartupScript methode van de ClientScriptManager klasse. U kunt een verwijzing naar het ClientScriptManager object ophalen uit de ClientScript eigenschap van de pagina.

Het scriptblok dat door de RegisterStartupScript methode wordt weergegeven, wordt uitgevoerd wanneer de pagina klaar is met laden, maar voordat de clientgebeurtenis onload van de pagina wordt gegenereerd. Opstartscriptblokken bevinden zich onder aan de weergegeven ASP.NET pagina vlak voor de tag </form>.

Opstartscriptblokken die zijn geregistreerd met behulp RegisterStartupScript van, worden niet gegarandeerd uitgevoerd in dezelfde volgorde waarin ze zijn geregistreerd. Als de volgorde van de opstartscriptblokken belangrijk is, gebruikt u een StringBuilder object om de scriptblokken in één tekenreeks te verzamelen en ze vervolgens allemaal te registreren als één opstartscript.

Zie ook

Van toepassing op

RegisterStartupScript(Page, Type, String, String, Boolean)

Registreert een opstartscriptblok voor elke asynchrone postback met het ScriptManager besturingselement en voegt het scriptblok toe aan de pagina.

public:
 static void RegisterStartupScript(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);
public static void RegisterStartupScript(System.Web.UI.Page page, Type type, string key, string script, bool addScriptTags);
static member RegisterStartupScript : System.Web.UI.Page * Type * string * string * bool -> unit
Public Shared Sub RegisterStartupScript (page As Page, type As Type, key As String, script As String, addScriptTags As Boolean)

Parameters

page
Page

Het paginaobject dat het clientscriptblok registreert.

type
Type

Het type clientscriptblok. Deze parameter wordt meestal opgegeven met behulp van de typeof-operator (C#) of de GetType-operator (Visual Basic) om het type besturingselement op te halen dat het script registreert.

key
String

Een unieke id voor het scriptblok.

script
String

Het script dat moet worden geregistreerd.

addScriptTags
Boolean

trueom het scriptblok met <script> en </script> tags in te sluiten; anders. false

Opmerkingen

U gebruikt deze methode om een opstartscriptblok te registreren dat wordt opgenomen telkens wanneer een asynchrone postback plaatsvindt. Als u een scriptblok wilt registreren voor een besturingselement dat zich in een UpdatePanel besturingselement bevindt, zodat het scriptblok alleen wordt geregistreerd wanneer het UpdatePanel besturingselement wordt bijgewerkt, gebruikt u de RegisterStartupScript(Control, Type, String, String, Boolean) overbelasting van deze methode.

Als u een opstartscript wilt registreren dat niet betrekking heeft op updates van gedeeltelijke pagina's en als u het script slechts één keer wilt registreren tijdens de eerste paginaweergave, gebruikt u de RegisterStartupScript methode van de ClientScriptManager klasse. U kunt een verwijzing naar het ClientScriptManager object ophalen uit de ClientScript eigenschap van de pagina.

Zie ook

Van toepassing op