ScriptManager.RegisterArrayDeclaration Methode

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)

Parameter

Ausnahmen

Hinweise

Sie verwenden die RegisterArrayDeclaration Methode, um ein Clientskriptarray zu registrieren, das mit teilweisem Seitenrendering kompatibel ist und keine Abhängigkeiten der Microsoft Ajax-Bibliothek aufweist. Mit dieser Methode wird das Array registriert, wenn control es sich um ein Steuerelement handelt, das sich in einem UpdatePanel Steuerelement befindet, das aktualisiert wird. Wenn Sie jedes Mal, wenn ein asynchroner Postback auftritt, ein Array registrieren möchten, verwenden Sie die RegisterArrayDeclaration(Page, String, String) Überladung dieser Methode.

Wenn Sie ein Array registrieren möchten, das sich nicht auf Teilseitenaktualisierungen bezieht, und wenn Sie das Array nur einmal während des ersten Seitenrenderings registrieren möchten, verwenden Sie die RegisterArrayDeclaration Methode der ClientScriptManager Klasse. Sie können einen Verweis auf das ClientScriptManager Objekt aus der ClientScript Eigenschaft der Seite abrufen.

Die RegisterArrayDeclaration Methode bestimmt, ob bereits ein Array mit dem im arrayName Parameter angegebenen Namen registriert ist. Wenn ja, fügt die Methode die in arrayValue. Da das zu registrierende Array auf der ArrayList Klasse basiert, sind Duplikate zulässig. Wenn kein registriertes Array mit dem Namen arrayName vorhanden ist, wird das Array erstellt, und die darin enthaltenen Werte arrayValue werden hinzugefügt.

Um Zeichenfolgenliterale in das Array einzuschließen, verwenden Sie einfache Anführungszeichen (') oder escaped doppelte Anführungszeichen (\") in arrayValue.

Beachten Sie, dass JavaScript ein Komma (,) als Trennzeichen in einem Array behandelt. Sie können mehrere Arraywerte angeben, indem Sie eine durch Trennzeichen getrennte Zeichenfolge in arrayValueübergeben. Das Trennen von zwei Elementen mit einem Komma arrayValue entspricht dem zweimaligen Aufrufen der RegisterArrayDeclaration Methode, einmal für jedes Element.

Weitere Informationen

• RegisterArrayDeclaration(Page, String, String)

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)

Parameter

Ausnahmen

Hinweise

Sie verwenden die RegisterArrayDeclaration Methode, um ein Clientskriptarray zu registrieren, das mit teilweisem Seitenrendering kompatibel ist und keine Abhängigkeiten der Microsoft Ajax-Bibliothek aufweist. Diese Methode registriert das Array jedes Mal, wenn ein asynchroner Postback auftritt. Um ein Array für ein Steuerelement zu registrieren, das sich innerhalb eines UpdatePanel Steuerelements befindet, damit das Array nur registriert wird, wenn das Panel aktualisiert wird, verwenden Sie die RegisterArrayDeclaration(Control, String, String) Überladung dieser Methode.

Wenn Sie ein Array registrieren möchten, das sich nicht auf Teilseitenaktualisierungen bezieht, und wenn Sie das Array nur einmal während des ersten Seitenrenderings registrieren möchten, verwenden Sie die RegisterArrayDeclaration Methode der ClientScriptManager Klasse. Sie können einen Verweis auf das ClientScriptManager Objekt aus der ClientScript Eigenschaft der Seite abrufen.

Weitere Informationen

• RegisterArrayDeclaration(Control, String, String)