ScriptManager.RegisterArrayDeclaration Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI
Assembly:
System.Web.Extensions.dll

Inscrit une déclaration de tableau ECMAScript (JavaScript) avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l’intérieur d’un contrôle UpdatePanel et ajoute le tableau à la page.

Surcharges

RegisterArrayDeclaration(Control, String, String)

Inscrit une déclaration de tableau ECMAScript (JavaScript) avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l’intérieur d’un contrôle UpdatePanel et ajoute le tableau à la page.
RegisterArrayDeclaration(Page, String, String)

Inscrit une déclaration de tableau ECMAScript (JavaScript) avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l’intérieur d’un contrôle UpdatePanel et ajoute le tableau à la page.

RegisterArrayDeclaration(Control, String, String)

Inscrit une déclaration de tableau ECMAScript (JavaScript) avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l’intérieur d’un contrôle UpdatePanel et ajoute le tableau à la page.

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)

Paramètres

control
Control

Contrôle qui inscrit le tableau.

arrayName
String

Nom du tableau à inscrire.

arrayValue
String

Valeur(s) de tableau à inscrire.

Exceptions

ArgumentNullException

arrayName a la valeur null.

Remarques

Vous utilisez la RegisterArrayDeclaration méthode pour inscrire un tableau de scripts client compatible avec le rendu de page partielle et qui n’a aucune dépendance de bibliothèque Microsoft Ajax. Cette méthode inscrit le tableau quand control représente un contrôle à l’intérieur d’un UpdatePanel contrôle mis à jour. Pour inscrire un tableau chaque fois qu’une publication asynchrone se produit, utilisez la RegisterArrayDeclaration(Page, String, String) surcharge de cette méthode.

Si vous souhaitez inscrire un tableau qui ne se rapporte pas aux mises à jour partielles de page, et si vous souhaitez inscrire le tableau une seule fois lors du rendu de page initial, utilisez la RegisterArrayDeclaration méthode de la ClientScriptManager classe. Vous pouvez obtenir une référence à l’objet ClientScriptManager à partir de la ClientScript propriété de la page.

La RegisterArrayDeclaration méthode détermine si un tableau portant le nom spécifié dans le arrayName paramètre est déjà inscrit. Dans ce cas, la méthode ajoute les valeurs spécifiées dans arrayValue. Étant donné que le tableau à inscrire est basé sur la ArrayList classe, les doublons sont autorisés. Si un tableau inscrit avec le nom dans arrayName n’existe pas, le tableau est créé et les valeurs contenues arrayValue sont ajoutées à celui-ci.

Pour inclure des littéraux de chaîne dans le tableau, utilisez des guillemets simples (') ou des guillemets doubles échapés (\« ) dans arrayValue.

Notez que JavaScript traite une virgule (,) comme un délimiteur dans un tableau. Vous pouvez spécifier plusieurs valeurs de tableau en passant une chaîne délimitée par des virgules dans arrayValue. La séparation de deux éléments avec une virgule arrayValue équivaut à appeler la RegisterArrayDeclaration méthode deux fois, une fois pour chaque élément.

Voir aussi

S’applique à

RegisterArrayDeclaration(Page, String, String)

Inscrit une déclaration de tableau ECMAScript (JavaScript) avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l’intérieur d’un contrôle UpdatePanel et ajoute le tableau à la page.

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)

Paramètres

page
Page

Objet page qui inscrit le tableau.

arrayName
String

Nom du tableau à inscrire.

arrayValue
String

Valeur(s) de tableau à inscrire.

Exceptions

ArgumentNullException

arrayName a la valeur null.

Remarques

Vous utilisez la RegisterArrayDeclaration méthode pour inscrire un tableau de scripts client compatible avec le rendu de page partielle et qui n’a aucune dépendance de bibliothèque Microsoft Ajax. Cette méthode inscrit le tableau chaque fois qu’une publication asynchrone se produit. Pour inscrire un tableau pour un contrôle à l’intérieur d’un UpdatePanel contrôle afin que le tableau soit inscrit uniquement lorsque le panneau est mis à jour, utilisez la RegisterArrayDeclaration(Control, String, String) surcharge de cette méthode.

Si vous souhaitez inscrire un tableau qui ne se rapporte pas aux mises à jour partielles de page, et si vous souhaitez inscrire le tableau une seule fois lors du rendu de page initial, utilisez la RegisterArrayDeclaration méthode de la ClientScriptManager classe. Vous pouvez obtenir une référence à l’objet ClientScriptManager à partir de la ClientScript propriété de la page.

Voir aussi

S’applique à