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 teilseitigem Rendern kompatibel ist und keine Abhängigkeiten von Microsoft Ajax Library aufweist. Diese Methode registriert das Array, wenn control ein Steuerelement in einem UpdatePanel Steuerelement dargestellt wird, das aktualisiert wird. Verwenden Sie die RegisterArrayDeclaration(Page, String, String) Überladung dieser Methode, um jedes Mal ein Array zu registrieren, wenn ein asynchroner Postback auftritt.

Wenn Sie ein Array registrieren möchten, das sich nicht auf Teilseitenupdates 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 über die ClientScript Eigenschaft der Seite abrufen.

Die RegisterArrayDeclaration Methode bestimmt, ob ein Array mit dem Namen, der im arrayName Parameter angegeben ist, bereits 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 ein registriertes Array mit dem Namen arrayName nicht 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. Das Trennen von zwei Elementen mit einem Komma arrayValue entspricht dem zweimaligen Aufrufen der RegisterArrayDeclaration Methode, einmal für jedes Element.

Siehe auch

• 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 teilseitigem Rendern kompatibel ist und keine Abhängigkeiten von Microsoft Ajax Library aufweist. Diese Methode registriert das Array jedes Mal, wenn ein asynchroner Postback auftritt. Wenn Sie ein Array für ein Steuerelement registrieren möchten, das sich innerhalb eines UpdatePanel Steuerelements befindet, damit das Array nur registriert wird, wenn der Bereich aktualisiert wird, verwenden Sie die RegisterArrayDeclaration(Control, String, String) Überladung dieser Methode.

Wenn Sie ein Array registrieren möchten, das sich nicht auf Teilseitenupdates 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 über die ClientScript Eigenschaft der Seite abrufen.

Siehe auch

• RegisterArrayDeclaration(Control, String, String)