ScriptManager.RegisterArrayDeclaration Méthode

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

Exceptions

Remarques

Vous utilisez la RegisterArrayDeclaration méthode pour inscrire un tableau de scripts client compatible avec le rendu de pages partielles et qui n’a aucune dépendance de bibliothèque Microsoft Ajax. Cette méthode inscrit le tableau lorsqu’elle control représente un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle en cours de mise à 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 concerne pas les mises à jour partielles de page et si vous souhaitez inscrire le tableau une seule fois pendant le 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. Si c’est le 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 portant le nom arrayName n’existe pas, le tableau est créé et les valeurs dans arrayValue ce tableau sont ajoutées.

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 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

• 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)

Paramètres

Exceptions

Remarques

Vous utilisez la RegisterArrayDeclaration méthode pour inscrire un tableau de scripts client compatible avec le rendu de pages partielles 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 qui se trouve à 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 concerne pas les mises à jour partielles de page et si vous souhaitez inscrire le tableau une seule fois pendant le 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

• RegisterArrayDeclaration(Control, String, String)