ScriptManager.RegisterArrayDeclaration Metod

Definition

Namnområde:
System.Web.UI
Sammansättning:
System.Web.Extensions.dll

Registrerar en ECMAScript-matrisdeklaration (JavaScript) med ScriptManager kontrollen för användning med en kontroll som finns i en UpdatePanel kontroll och lägger till matrisen på sidan.

Överlagringar

Name Description
RegisterArrayDeclaration(Control, String, String)

Registrerar en ECMAScript-matrisdeklaration (JavaScript) med ScriptManager kontrollen för användning med en kontroll som finns i en UpdatePanel kontroll och lägger till matrisen på sidan.
RegisterArrayDeclaration(Page, String, String)

Registrerar en ECMAScript-matrisdeklaration (JavaScript) med ScriptManager kontrollen för användning med en kontroll som finns i en UpdatePanel kontroll och lägger till matrisen på sidan.

RegisterArrayDeclaration(Control, String, String)

Registrerar en ECMAScript-matrisdeklaration (JavaScript) med ScriptManager kontrollen för användning med en kontroll som finns i en UpdatePanel kontroll och lägger till matrisen på sidan.

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)

Parametrar

control
Control

Kontrollen som registrerar matrisen.

arrayName
String

Namnet på matrisen som ska registreras.

arrayValue
String

Matrisvärdet eller värdena som ska registreras.

Undantag

ArgumentNullException

arrayName är null.

Kommentarer

Du använder metoden RegisterArrayDeclaration för att registrera en klientskriptmatris som är kompatibel med partiell sidåtergivning och som inte har några Microsoft Beroenden för Ajax-bibliotek. Den här metoden registrerar matrisen när control den representerar en kontroll som finns i en UpdatePanel kontroll som uppdateras. Om du vill registrera en matris varje gång en asynkron postback inträffar använder du överlagringen av den RegisterArrayDeclaration(Page, String, String) här metoden.

Om du vill registrera en matris som inte avser partiella siduppdateringar och om du bara vill registrera matrisen en gång under den inledande sidåtergivningen RegisterArrayDeclaration använder du -metoden för ClientScriptManager klassen. Du kan hämta en referens till ClientScriptManager objektet från ClientScript sidans egenskap.

Metoden RegisterArrayDeclaration avgör om en matris med det namn som anges i parametern arrayName redan är registrerad. I så fall lägger metoden till de värden som anges i arrayValue. Eftersom matrisen som ska registreras baseras på ArrayList klassen tillåts dubbletter. Om det inte finns någon registrerad matris med namnet i arrayName skapas matrisen och värdena i arrayValue läggs till i den.

Om du vill inkludera strängliteraler i matrisen använder du enkla citattecken (') eller undantagna dubbla citattecken (\") i arrayValue.

Observera att JavaScript behandlar ett kommatecken (,) som en avgränsare i en matris. Du kan ange flera matrisvärden genom att skicka en kommaavgränsad sträng i arrayValue. Att separera två objekt med kommatecken i arrayValue motsvarar att anropa RegisterArrayDeclaration metoden två gånger, en gång för varje objekt.

Se även

Gäller för

RegisterArrayDeclaration(Page, String, String)

Registrerar en ECMAScript-matrisdeklaration (JavaScript) med ScriptManager kontrollen för användning med en kontroll som finns i en UpdatePanel kontroll och lägger till matrisen på sidan.

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)

Parametrar

page
Page

Sidobjektet som registrerar matrisen.

arrayName
String

Namnet på matrisen som ska registreras.

arrayValue
String

Matrisvärdet eller värdena som ska registreras.

Undantag

ArgumentNullException

arrayName är null.

Kommentarer

Du använder metoden RegisterArrayDeclaration för att registrera en klientskriptmatris som är kompatibel med partiell sidåtergivning och som inte har några Microsoft Beroenden för Ajax-bibliotek. Den här metoden registrerar matrisen varje gång en asynkron postback inträffar. Om du vill registrera en matris för en kontroll som finns i en UpdatePanel kontroll så att matrisen endast registreras när panelen uppdateras använder du överbelastningen RegisterArrayDeclaration(Control, String, String) av den här metoden.

Om du vill registrera en matris som inte avser partiella siduppdateringar och om du bara vill registrera matrisen en gång under den inledande sidåtergivningen RegisterArrayDeclaration använder du -metoden för ClientScriptManager klassen. Du kan hämta en referens till ClientScriptManager objektet från ClientScript sidans egenskap.

Se även

Gäller för