ScriptManager.RegisterArrayDeclaration Methode

Definitie

Naamruimte:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Registreert een ECMAScript-matrixdeclaratie (JavaScript) met het ScriptManager besturingselement voor gebruik met een besturingselement dat zich in een UpdatePanel besturingselement bevindt en voegt de matrix toe aan de pagina.

Overloads

Name	Description
RegisterArrayDeclaration(Control, String, String)	Registreert een ECMAScript-matrixdeclaratie (JavaScript) met het ScriptManager besturingselement voor gebruik met een besturingselement dat zich in een UpdatePanel besturingselement bevindt en voegt de matrix toe aan de pagina.
RegisterArrayDeclaration(Page, String, String)	Registreert een ECMAScript-matrixdeclaratie (JavaScript) met het ScriptManager besturingselement voor gebruik met een besturingselement dat zich in een UpdatePanel besturingselement bevindt en voegt de matrix toe aan de pagina.

RegisterArrayDeclaration(Control, String, String)

Registreert een ECMAScript-matrixdeclaratie (JavaScript) met het ScriptManager besturingselement voor gebruik met een besturingselement dat zich in een UpdatePanel besturingselement bevindt en voegt de matrix toe aan de pagina.

public:
 static void RegisterArrayDeclaration(System::Web::UI::Control ^ control, System::String ^ arrayName, System::String ^ arrayValue);

public static void RegisterArrayDeclaration(System.Web.UI.Control control, string arrayName, string arrayValue);

static member RegisterArrayDeclaration : System.Web.UI.Control * string * string -> unit

Public Shared Sub RegisterArrayDeclaration (control As Control, arrayName As String, arrayValue As String)

Parameters

control

Control

Het besturingselement dat de matrix registreert.

arrayName

String

De naam van de matrix die moet worden geregistreerd.

arrayValue

String

De matrixwaarde of -waarden die moeten worden geregistreerd.

Uitzonderingen

ArgumentNullException

arrayName is null.

Opmerkingen

U gebruikt de methode RegisterArrayDeclaration om een clientscriptmatrix te registreren die compatibel is met gedeeltelijke paginaweergave en die geen Microsoft Ajax-bibliotheekafhankelijkheden heeft. Met deze methode wordt de matrix geregistreerd wanneer control het een besturingselement vertegenwoordigt dat zich in een UpdatePanel besturingselement bevindt dat wordt bijgewerkt. Als u een matrix wilt registreren telkens wanneer een asynchrone postback plaatsvindt, gebruikt u de RegisterArrayDeclaration(Page, String, String) overbelasting van deze methode.

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

De RegisterArrayDeclaration methode bepaalt of een matrix met de naam die is opgegeven in de arrayName parameter al is geregistreerd. Zo ja, dan voegt de methode de waarden toe die zijn opgegeven in arrayValue. Omdat de matrix die moet worden geregistreerd, is gebaseerd op de ArrayList klasse, zijn duplicaten toegestaan. Als er geen geregistreerde matrix met de naam bestaat arrayName , wordt de matrix gemaakt en worden de waarden arrayValue eraan toegevoegd.

Als u letterlijke tekenreeksen in de matrix wilt opnemen, gebruikt u enkele aanhalingstekens (') of dubbele aanhalingstekens (\") in arrayValue.

JavaScript behandelt een komma (,) als scheidingsteken in een matrix. U kunt meerdere matrixwaarden opgeven door een door komma's gescheiden tekenreeks door te geven in arrayValue. Het scheiden van twee items met een komma komt arrayValue overeen met het aanroepen van de RegisterArrayDeclaration methode twee keer, één keer voor elk item.

Zie ook

• RegisterArrayDeclaration(Page, String, String)

RegisterArrayDeclaration(Page, String, String)

Registreert een ECMAScript-matrixdeclaratie (JavaScript) met het ScriptManager besturingselement voor gebruik met een besturingselement dat zich in een UpdatePanel besturingselement bevindt en voegt de matrix toe aan de pagina.

public:
 static void RegisterArrayDeclaration(System::Web::UI::Page ^ page, System::String ^ arrayName, System::String ^ arrayValue);

public static void RegisterArrayDeclaration(System.Web.UI.Page page, string arrayName, string arrayValue);

static member RegisterArrayDeclaration : System.Web.UI.Page * string * string -> unit

Public Shared Sub RegisterArrayDeclaration (page As Page, arrayName As String, arrayValue As String)

Parameters

page

Page

Het paginaobject dat de matrix registreert.

arrayName

String

De naam van de matrix die moet worden geregistreerd.

arrayValue

String

De matrixwaarde of -waarden die moeten worden geregistreerd.

Uitzonderingen

ArgumentNullException

arrayName is null.

Opmerkingen

U gebruikt de methode RegisterArrayDeclaration om een clientscriptmatrix te registreren die compatibel is met gedeeltelijke paginaweergave en die geen Microsoft Ajax-bibliotheekafhankelijkheden heeft. Deze methode registreert de matrix telkens wanneer een asynchrone postback plaatsvindt. Als u een matrix wilt registreren voor een besturingselement dat zich in een UpdatePanel besturingselement bevindt, zodat de matrix alleen wordt geregistreerd wanneer het paneel wordt bijgewerkt, gebruikt u de RegisterArrayDeclaration(Control, String, String) overbelasting van deze methode.

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

Zie ook

• RegisterArrayDeclaration(Control, String, String)