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

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

• RegisterArrayDeclaration(Control, String, String)