UpdateProgress, contrôle

Le contrôle UpdateProgress fournit des informations d’état à propos des mises à jour de pages partielles dans les contrôles UpdatePanel . Vous pouvez personnaliser le contenu et la disposition par défaut du contrôle UpdateProgress . Pour éviter le clignotement lorsqu’une mise à jour de page partielle est très rapide, vous pouvez spécifier un délai avant l’affichage du contrôle UpdateProgress .

Le contrôle UpdateProgress requiert des paramètres spécifiques dans un fichier web.config pour fonctionner correctement. Si vous essayez d’utiliser ce contrôle, et si votre site 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 un 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

Le contrôle UpdateProgress vous aide à concevoir une interface utilisateur plus intuitive quand une page Web contient un ou plusieurs contrôles UpdatePanel pour le rendu de page partielle. Si une mise à jour de page partielle est lente, vous pouvez utiliser le contrôle UpdateProgress pour fournir une indication visuelle sur l’état de la mise à jour. Vous pouvez placer de nombreux contrôles UpdateProgress sur une page, chacun associé à un contrôle UpdatePanel différent. Vous pouvez également utiliser un contrôle UpdateProgress et l’associer à tous les autres contrôles UpdatePanel de la page.

Background (arrière-plan)

Le contrôle UpdateProgress assure le rendu d’un élément DIV qui est affiché ou masqué selon qu’un contrôle UpdatePanel associé a provoqué une publication asynchrone. Pour le rendu de page initiale et les publications synchrones, le contrôle UpdateProgress n’est pas affiché.

Associer un contrôle UpdateProgress à un contrôle UpdatePanel

Vous associez un contrôle UpdateProgress à un contrôle UpdatePanel en définissant la propriété AssociatedUpdatePanelID du contrôle UpdateProgress . Lorsqu’un événement de publication provient d’un contrôle UpdatePanel , les contrôles UpdateProgress associés sont affichés. Si vous n’associez pas le contrôle UpdateProgress à un contrôle UpdatePanel spécifique, le contrôle UpdateProgress affiche la progression des publications asynchrones.

Si la propriété ChildrenAsTriggers d’un contrôle UpdatePanel a la valeur false et si une publication asynchrone provient de ce contrôle UpdatePanel , tous les contrôles UpdateProgress associés sont affichés.

Créer du contenu pour le contrôle UpdateProgress

Pour spécifier le message affiché par un contrôle UpdateProgress , placez le contenu souhaité dans le panneau en mode Création. Par exemple, vous pouvez faire glisser d’autres contrôles ASP.NET et HTML vers le panneau, puis placer le curseur dans le panneau et taper directement dans ce dernier. Lorsque vous ajoutez un message à un contrôle UpdateProgress en mode Création, les balises <ProgressTemplate> requises sont automatiquement ajoutées autour du contenu. Si vous ajoutez du contenu à un contrôle UpdateProgress en mode Code au lieu du mode Création, vous devez ajouter manuellement les balises <ProgressTemplate></ProgressTemplate> si elles n’existent pas déjà ; sinon, le message ne sera pas affiché.

Spécifier la disposition du contenu

Lorsque la propriété DynamicLayout a la valeur true, le contrôle UpdateProgress n’occupe initialement aucun espace dans l’affichage de la page. En revanche, la page change de manière dynamique pour afficher le contrôle UpdateProgress lorsque cela est nécessaire. Pour prendre en charge l’affichage dynamique, le contrôle est rendu en tant qu’élément DIV dont la propriété de style display a initialement la valeur none.

Lorsque la propriété DynamicLayout est false, le contrôle UpdateProgress occupe de l’espace dans l’affichage de page, même s’il n’est pas visible. Dans ce cas, le jeu de propriétés de l’élément <div> du contrôle est défini à block et son paramètre de visibilité est initialement défini à hidden.

Placer les contrôles UpdateProgress sur la page

Vous pouvez placer des contrôles UpdateProgress à l’intérieur ou à l’extérieur des contrôles UpdatePanel . Un contrôle UpdateProgress s’affiche chaque fois que le contrôle UpdatePanel auquel il est associé est mis à jour à la suite d’une publication asynchrone. Cela est vrai même si le contrôle UpdateProgress se trouve à l’intérieur d’un autre contrôle UpdatePanel .

Si un contrôle UpdatePanel est à l’intérieur d’un autre panneau de mise à jour, une publication provenant de l’intérieur du panneau enfant provoque l’affichage de tous les contrôles UpdateProgress associés au panneau enfant. Il affiche également tous les contrôles UpdateProgress associés au panneau parent. Si une publication provient d’un contrôle enfant immédiat du panneau parent, seuls les contrôles UpdateProgress associés au panneau parent sont affichés. Cela respecte la logique de déclenchement des publications.

Pour plus d’informations sur le contrôle UpdateProgress , voir les détails relatifs à la vue d’ensemble du contrôle UpdateProgress  dans MSDN Library.

Pour obtenir une description de toutes les propriétés du contrôle UpdateProgress , voir les détails relatifs aux propriétés du contrôle UpdateProgress  dans MSDN Library.

Voir aussi

Concepts

contrôles ASP.NET AJAX