ScriptManager.RegisterArrayDeclaration Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Registriert eine ECMAScript-Arraydeklaration (JavaScript) beim ScriptManager-Steuerelement für die Verwendung mit einem Steuerelement, das sich innerhalb eines UpdatePanel-Steuerelements befindet, und fügt das Array der Seite hinzu.

Überlädt

RegisterArrayDeclaration(Control, String, String)	Registriert eine ECMAScript-Arraydeklaration (JavaScript) beim ScriptManager-Steuerelement für die Verwendung mit einem Steuerelement, das sich innerhalb eines UpdatePanel-Steuerelements befindet, und fügt das Array der Seite hinzu.
RegisterArrayDeclaration(Page, String, String)	Registriert eine ECMAScript-Arraydeklaration (JavaScript) beim ScriptManager-Steuerelement für die Verwendung mit einem Steuerelement, das sich innerhalb eines UpdatePanel-Steuerelements befindet, und fügt das Array der Seite hinzu.

RegisterArrayDeclaration(Control, String, String)

Registriert eine ECMAScript-Arraydeklaration (JavaScript) beim ScriptManager-Steuerelement für die Verwendung mit einem Steuerelement, das sich innerhalb eines UpdatePanel-Steuerelements befindet, und fügt das Array der Seite hinzu.

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

control

Control

Das Steuerelement, das das Array registriert.

arrayName

String

Der Name des zu registrierenden Arrays.

arrayValue

String

Der zu registrierende Arraywert bzw. die zu registrierenden Arraywerte.

Ausnahmen

ArgumentNullException

arrayName ist null.

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)

RegisterArrayDeclaration(Page, String, String)

Registriert eine ECMAScript-Arraydeklaration (JavaScript) beim ScriptManager-Steuerelement für die Verwendung mit einem Steuerelement, das sich innerhalb eines UpdatePanel-Steuerelements befindet, und fügt das Array der Seite hinzu.

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

page

Page

Das Seitenobjekt, das das Array registriert.

arrayName

String

Der Name des zu registrierenden Arrays.

arrayValue

String

Der zu registrierende Arraywert bzw. die zu registrierenden Arraywerte.

Ausnahmen

ArgumentNullException

arrayName ist null.

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)