ScriptManager, contrôle
Le contrôle ScriptManager gère le script client des pages Web ASP.NET AJAX. Par défaut, le contrôle ScriptManager inscrit le script de Microsoft AJAX Library avec la page. Ainsi, le script client peut utiliser les extensions système de type et prendre en charge des fonctionnalités telles que le rendu de page partielle et les appels de service Web.
Le contrôle ScriptManager requiert des paramètres spécifiques dans un fichier web.config pour fonctionner correctement. Si vous essayez d’utiliser ce contrôle et que votre site Web ne contient pas le fichier web.config requis, des erreurs apparaissent dans le mode Création de la page où le contrôle est censé s’afficher. En mode Création, si vous cliquez sur le contrôle qui se trouve dans cet état, Microsoft Expression Web vous donne la possibilité de créer un fichier web.config ou de mettre à jour votre fichier web.config existant.
Scénarios
Vous devez utiliser un contrôle ScriptManager sur une page pour activer les fonctionnalités AJAX suivantes d’ASP.NET :
Fonctionnalité de script client de Microsoft AJAX Library et tout script personnalisé à envoyer au navigateur.
Rendu de page partielle, qui permet d’actualiser des régions individuelles de la page sans publication. Les contrôles ASP.NET UpdatePanel, UpdateProgress et Timer ont besoin d’un contrôle ScriptManager pour prendre en charge le rendu de page partielle.
Classes de proxy JavaScript pour les services Web, qui permettent d’utiliser le script client pour accéder aux services Web et aux méthodes spécialement marquées des pages ASP.NET. Pour ce faire, il expose les services Web et les méthodes de page sous forme d’objets fortement typés.
Classes JavaScript pour accéder aux services d’authentification, de profil et d’application de rôles ASP.NET.
Arrière-plan
Lorsqu’une page contient un ou plusieurs contrôles UpdatePanel, le contrôle ScriptManager gère le rendu de page partielle dans le navigateur. Le contrôle interagit avec le cycle de vie de la page pour en mettre à jour les portions qui se trouvent à l’intérieur des contrôles UpdatePanel. Pour plus d’informations, voir Vue d’ensemble du rendu de page partielle.
La propriété EnablePartialRendering du contrôle ScriptManager détermine si une page participe aux mises à jour de page partielle. Par défaut, la propriété EnablePartialRendering est définie sur true. Par conséquent, le rendu de page partielle est activé par défaut lorsque vous ajoutez un contrôle ScriptManager à la page. Pour plus d’informations sur l’utilisation du contrôle UpdatePanel avec le contrôle ScriptManager, voir Didacticiel : actualiser un contrôle UpdatePanel selon un intervalle de minuterie et Didacticiel : comment créer une page avec deux zones pouvant être mises à jour de manière indépendante.
Classe ScriptManagerProxy
Une seule instance du contrôle ScriptManager peut être ajoutée à une page. La page peut contenir le contrôle directement, ou indirectement à l’intérieur d’un composant imbriqué, par exemple un contrôle utilisateur, une page de contenu pour une page maître ou une page maître imbriquée. Si une page contient déjà un contrôle ScriptManager alors qu’un composant imbriqué ou parent a besoin de fonctionnalités supplémentaires du contrôle ScriptManager, le composant peut inclure un contrôle ScriptManagerProxy. Par exemple, le contrôle ScriptManagerProxy permet d’ajouter des scripts et des services réservés aux composants imbriqués. Pour plus d’informations, voir ScriptManagerProxy, contrôle.
Pour plus d’informations sur le contrôle ScriptManager, voir la présentation du contrôle ScriptManager dans MSDN Library.
Pour une description de toutes les propriétés du contrôle ScriptManager, voir la rubrique concernant les propriétés de ScriptManager dans MSDN Library.