Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

ScriptManager, classe

Gère des fichiers de script et des bibliothèques de scripts ASP.NET Ajax, le rendu de page partiel et la génération de classe du proxy client pour les services Web et d'application.

System.Object
  System.Web.UI.Control
    System.Web.UI.ScriptManager

Espace de noms :  System.Web.UI
Assembly :  System.Web.Extensions (dans System.Web.Extensions.dll)
public class ScriptManager : Control, 
	IPostBackDataHandler, IPostBackEventHandler
<asp:ScriptManager />

Le type ScriptManager expose les membres suivants.

  NomDescription
Méthode publiqueScriptManagerInitialise une nouvelle instance de la classe ScriptManager.
Début
  NomDescription
Propriété protégéeAdapterObtient l'adaptateur spécifiques au navigateur pour le contrôle. (Hérité de Control.)
Propriété publiqueAjaxFrameworkAssemblyObtient l'assembly Framework Ajax utilisé par les composants sur la page.
Propriété publiqueAjaxFrameworkModeObtient ou définit une valeur qui définit la façon dont les scripts clients de la bibliothèque cliente Microsoft Ajax doivent être inclus dans le client.
Propriété publiqueAllowCustomErrorsRedirectObtient ou définit une valeur qui détermine si la section d'erreurs personnalisées du fichier Web.config est utilisée lors d'une erreur dans une publication (postback) asynchrone.
Propriété publiqueAppRelativeTemplateSourceDirectoryObtient ou définit le répertoire virtuel relatif à l'application de l'objet d' Page ou d' UserControl qui contient ce contrôle. (Hérité de Control.)
Propriété publiqueAsyncPostBackErrorMessageObtient ou définit le message d'erreur envoyé au client lorsqu'une exception de serveur non gérée se produit lors d'une publication (postback) asynchrone.
Propriété publiqueAsyncPostBackSourceElementIDObtient l'ID unique du contrôle qui a provoqué la publication (postback) asynchrone.
Propriété publiqueAsyncPostBackTimeoutObtient ou définit une valeur qui indique la durée, en secondes, avant l'expiration des publications (postback) asynchrones si aucune réponse n'est reçue.
Propriété publiqueAuthenticationServiceObtient l'objet AuthenticationServiceManager associé à l'instance ScriptManager en cours.
Propriété publiqueBindingContainerInfrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.)
Propriété protégéeChildControlsCreatedObtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control.)
Propriété publiqueClientIDObtient l'ID du contrôle pour la balise HTML qui est générée par ASP.NET. (Hérité de Control.)
Propriété publiqueClientIDModeObtient ou définit l'algorithme utilisé pour générer la valeur de la propriété d' ClientID . (Hérité de Control.)
Propriété protégéeClientIDSeparatorObtient une valeur de caractères représentant le caractère de séparation utilisé dans la propriété d' ClientID . (Hérité de Control.)
Propriété publiqueClientNavigateHandlerObtient ou définit le nom de la méthode qui gère l'événement Sys.Application.navigate sur le client.
Propriété publiqueCompositeScriptObtient une référence au script composite qui prend en charge la page Web.
Propriété protégéeContextObtient l'objet d' HttpContext associé au contrôle serveur pour la requête Web active. (Hérité de Control.)
Propriété publiqueControlsObtient un objet d' ControlCollection qui représente les contrôles enfants pour un contrôle serveur spécifié dans la hiérarchie d'interface utilisateur. (Hérité de Control.)
Propriété publiqueDataItemContainerObtient une référence au conteneur d'attribution de noms si le conteneur d'attribution de noms implémente IDataItemContainer. (Hérité de Control.)
Propriété publiqueDataKeysContainerObtient une référence au conteneur d'attribution de noms si le conteneur d'attribution de noms implémente IDataKeysControl. (Hérité de Control.)
Propriété protégéeDesignModeObtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control.)
Propriété publiqueEmptyPageUrlObtient ou définit une URL à une page Web vide.
Propriété publiqueEnableCdnDétermine si la page active charge des références de script client à partir de chemins d'accès CDN (Content Delivery Network).
Propriété publiqueEnableCdnFallbackPermet la copie locale d'un script dans le cas où le CDN (Content Delivery Network) n'est pas disponible.
Propriété publiqueEnableHistoryObtient ou définit une valeur qui indique si la page Web prend en charge la gestion des points d'historique.
Propriété publiqueEnablePageMethodsObtient ou définit une valeur qui indique si les méthodes de page statiques publiques d'une page ASP.NET peuvent être appelées par le script client.
Propriété publiqueEnablePartialRenderingObtient ou définit une valeur qui active le rendu partiel d'une page qui, à son tour, vous permet de mettre à jour des zones de la page individuellement à l'aide de contrôles UpdatePanel.
Propriété publiqueEnableScriptGlobalizationObtient ou définit une valeur qui indique si le contrôle ScriptManager restitue le script qui prend en charge l'analyse et la mise en forme des informations spécifiques à la culture.
Propriété publiqueEnableScriptLocalizationObtient ou définit une valeur qui indique si le contrôle ScriptManager restitue des versions localisées des fichiers de script.
Propriété publiqueEnableSecureHistoryStateObtient ou définit une valeur qui indique s'il faut chiffrer la chaîne d'état de l'historique.
Propriété publiqueEnableThemingObtient ou définit une valeur indiquant si les thèmes appliquent à ce contrôle. (Hérité de Control.)
Propriété publiqueEnableViewStateObtient ou définit une valeur indiquant si le contrôle serveur conserve son état d'affichage, et l'état d'affichage de tous les contrôles enfants qu'il contient, un client demandeur. (Hérité de Control.)
Propriété protégéeEventsObtient une liste des délégués de gestionnaire d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control.)
Propriété protégéeHasChildViewStateObtient une valeur indiquant si les contrôles enfants actuels du contrôle serveur ont des paramètres enregistrés d'état d'affichage. (Hérité de Control.)
Propriété publiqueIDObtient ou définit l'identificateur programmatique assigné au contrôle serveur. (Hérité de Control.)
Propriété protégéeIdSeparatorInfrastructure. Obtient le caractère utilisé pour séparer les ID de contrôle. (Hérité de Control.)
Propriété protégéeIsChildControlStateClearedObtient une valeur indiquant si les contrôles contenus dans le contrôle ont l'état du contrôle. (Hérité de Control.)
Propriété publiqueIsDebuggingEnabledObtient une valeur qui indique si les versions debug de bibliothèques de scripts clients seront restituées.
Propriété publiqueIsInAsyncPostBackObtient une valeur qui indique si la publication (postback) en cours est exécutée en mode de rendu partiel.
Propriété publiqueIsNavigatingObtient une valeur qui indique si un événement Navigate est actuellement géré.
Propriété protégéeIsTrackingViewStateObtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control.)
Propriété protégéeIsViewStateEnabledObtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control.)
Propriété publiqueLoadScriptsBeforeUIObtient ou définit une valeur qui indique si les scripts sont chargés avant ou après le chargement du balisage pour l'interface utilisateur de la page.
Propriété protégéeLoadViewStateByIDObtient une valeur indiquant si le contrôle participe au chargement son état d'affichage par ID au lieu de l'index. (Hérité de Control.)
Propriété publiqueNamingContainerObtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un seul espace de noms pour différencier des contrôles serveur avec la même valeur de propriété d' Control.ID . (Hérité de Control.)
Propriété publiquePageObtient une référence à l'instance d' Page qui contient le contrôle serveur. (Hérité de Control.)
Propriété publiqueParentObtient une référence au contrôle du parent du contrôle serveur dans la hiérarchie des contrôles de la page. (Hérité de Control.)
Propriété publiqueProfileServiceObtient l'objet ProfileServiceManager associé à l'instance ScriptManager en cours.
Propriété publiqueRenderingCompatibilityObtient une valeur qui spécifie la version d'ASP.NET que le code HTML restitué sera compatible avec. (Hérité de Control.)
Propriété publiqueRoleServiceObtient l'objet RoleServiceManager associé à l'instance ScriptManager en cours.
Propriété publiqueScriptModeObtient ou définit une valeur qui spécifie si les versions Debug ou Release des bibliothèques de scripts clients sont restituées.
Propriété publiqueScriptPath Obsolète. Obtient ou définit le chemin d'accès racine de l'emplacement utilisé pour générer les chemins d'accès aux fichiers de script personnalisés et ASP.NET Ajax.
Propriété publiqueMembre statiqueScriptResourceMappingObtient un objet ScriptResourceMapping.
Propriété publiqueScriptsObtient un objet ScriptReferenceCollection qui contient les objets ScriptReference, chacun représentant un fichier de script restitué au client.
Propriété publiqueServicesObtient un objet ServiceReferenceCollection qui contient un objet ServiceReference pour chaque service Web qu'ASP.NET expose sur le client pour les fonctionnalités Ajax.
Propriété publiqueSiteObtient des informations sur le conteneur qui héberge le contrôle actuel lorsqu'il est affiché sur une aire de conception. (Hérité de Control.)
Propriété publiqueSkinIDObtient ou définit l'apparence d'appliquer au contrôle. (Hérité de Control.)
Propriété publiqueSupportsPartialRenderingObtient une valeur qui indique si le client prend en charge le rendu de page partiel.
Propriété publiqueTemplateControlObtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control.)
Propriété publiqueTemplateSourceDirectoryObtient le répertoire virtuel d' Page ou d' UserControl qui contient le contrôle serveur actuel. (Hérité de Control.)
Propriété publiqueUniqueIDObtient l'unique, de manière hiérarchique qualifié identificateur du contrôle serveur. (Hérité de Control.)
Propriété publiqueValidateRequestModeObtient ou définit une valeur qui indique si le contrôle vérifie l'entrée de client du navigateur pour les valeurs non sécurisées. (Hérité de Control.)
Propriété protégéeViewStateObtient un dictionnaire des informations d'état qui vous permettent d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur sur plusieurs demandes pour la même page. (Hérité de Control.)
Propriété protégéeViewStateIgnoresCaseObtient une valeur qui indique si l'objet d' StateBag ne respecte pas la casse. (Hérité de Control.)
Propriété publiqueViewStateModeObtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control.)
Propriété publiqueVisibleSubstitue la propriété Visible héritée de la classe Control de base pour empêcher la définition de cette valeur. (Substitue Control.Visible.)
Début
  NomDescription
Méthode protégéeAddedControlAppelé après un contrôle enfant est ajouté à la collection d' Controls de l'objet d' Control . (Hérité de Control.)
Méthode publiqueAddHistoryPoint(NameValueCollection, String)Crée un point d'historique et l'ajoute à la pile d'historique du navigateur, à l'aide de la collection de données d'état et du titre d'état spécifiés.
Méthode publiqueAddHistoryPoint(String, String)Crée un point d'historique et l'ajoute à la pile d'historique du navigateur, à l'aide de la clé d'état et de la valeur d'état spécifiées.
Méthode publiqueAddHistoryPoint(String, String, String)Crée un point d'historique et l'ajoute à la pile d'historique du navigateur, à l'aide de la clé d'état, de la valeur d'état et du titre d'état spécifiés.
Méthode protégéeAddParsedSubObjectInforme le contrôle serveur qu'un élément, XML ou HTML, a été analysé, et ajoute l'élément à l'objet d' ControlCollection du contrôle serveur. (Hérité de Control.)
Méthode publiqueApplyStyleSheetSkinApplique les propriétés de style définies dans la feuille de style de page au contrôle. (Hérité de Control.)
Méthode protégéeBeginRenderTracingDémarre le suivi au moment de le design des données de rendu. (Hérité de Control.)
Méthode protégéeBuildProfileTreeInfrastructure. Rassemble des informations à propos de le contrôle serveur et les fournit à la propriété d' Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control.)
Méthode protégéeClearCachedClientIDInfrastructure. Définit la valeur mise en cache d' ClientID à null. (Hérité de Control.)
Méthode protégéeClearChildControlStateSupprime les informations sur l'état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearChildStateSupprime l'état d'affichage et les informations sur l'état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearChildViewStateSupprime les informations d'état d'affichage pour des contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode protégéeClearEffectiveClientIDModeInfrastructure. Définit la propriété d' ClientIDMode de l'instance de contrôle actuelle et de tous les contrôles enfants à Inherit. (Hérité de Control.)
Méthode protégéeCreateChildControlsAppelé par l'infrastructure de page ASP.NET. pour informer les contrôles serveur qu'implémentation composition-basée par utilisation de pour créer tous contrôles enfants qu'ils contiennent pendant la vice versa ou du rendu de publication. (Hérité de Control.)
Méthode protégéeCreateControlCollectionCrée un nouvel objet d' ControlCollection pour contenir les contrôles enfants (littéral et serveur) du contrôle serveur. (Hérité de Control.)
Méthode publiqueDataBind()Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control.)
Méthode protégéeDataBind(Boolean)Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants avec une option de déclencher l'événement d' DataBinding . (Hérité de Control.)
Méthode protégéeDataBindChildrenLie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control.)
Méthode publiqueDisposePermet à un contrôle serveur pour effectuer la dernière nettoyer avant d'être libérée de la mémoire. (Hérité de Control.)
Méthode protégéeEndRenderTracingTermine le traçage au moment de le design des données de rendu. (Hérité de Control.)
Méthode protégéeEnsureChildControlsDétermine si le contrôle serveur contient des contrôles enfants. Dans le cas contraire, il crée des contrôles enfants. (Hérité de Control.)
Méthode protégéeEnsureIDCrée un identificateur pour les contrôles qui n'ont pas un identificateur assigné. (Hérité de Control.)
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueFindControl(String)Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec le paramètre spécifié d' id . (Hérité de Control.)
Méthode protégéeFindControl(String, Int32)Infrastructure. Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec id spécifié et un entier, spécifié dans le paramètre d' pathOffset , ce qui simplifie la recherche. Vous ne devez pas substituer cette version de la méthode d' FindControl . (Hérité de Control.)
Méthode publiqueFocusDéfinit le focus d'entrée à un contrôle. (Hérité de Control.)
Méthode publiqueMembre statiqueGetCurrentObtient l'instance ScriptManager pour un objet Page donné.
Méthode protégéeGetDesignModeStateInfrastructure. Obtient des données au moment de le design pour un contrôle. (Hérité de Control.)
Méthode publiqueGetHashCodeSert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publiqueGetRegisteredArrayDeclarationsRécupère une collection en lecture seule de déclarations de tableau ECMAScript (JavaScript) précédemment inscrites avec l'objet Page.
Méthode publiqueGetRegisteredClientScriptBlocksRécupère une collection en lecture seule de blocs de script client précédemment inscrits avec le contrôle ScriptManager.
Méthode publiqueGetRegisteredDisposeScriptsRécupère une collection en lecture seule de scripts dispose précédemment inscrits avec l'objet Page.
Méthode publiqueGetRegisteredExpandoAttributesRécupère une collection en lecture seule d'attributs personnalisés (expando) précédemment inscrits avec l'objet Page.
Méthode publiqueGetRegisteredHiddenFieldsRécupère une collection en lecture seule de champs masqués précédemment inscrits avec l'objet Page.
Méthode publiqueGetRegisteredOnSubmitStatementsRécupère une collection en lecture seule d'instructions onsubmit précédemment inscrites avec l'objet Page.
Méthode publiqueGetRegisteredStartupScriptsRécupère une collection en lecture seule de scripts de démarrage précédemment inscrits avec l'objet Page.
Méthode publiqueGetRouteUrl(Object)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(RouteValueDictionary)Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(String, Object)Obtient l'URL qui correspond à un jeu de paramètres de routage et d'un nom d'itinéraire. (Hérité de Control.)
Méthode publiqueGetRouteUrl(String, RouteValueDictionary)Obtient l'URL qui correspond à un jeu de paramètres de routage et d'un nom d'itinéraire. (Hérité de Control.)
Méthode publiqueGetStateStringRécupère une chaîne qui contient des paires clé/valeur qui représentent l'état de la page Web.
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueGetUniqueIDRelativeToRetourne la partie préfixée de la propriété d' UniqueID du contrôle spécifié. (Hérité de Control.)
Méthode publiqueHasControlsDétermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control.)
Méthode protégéeHasEventsRetourne une valeur indiquant si les événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control.)
Méthode protégéeIsLiteralContentInfrastructure. Détermine si le contrôle serveur contient uniquement le contenu littéral. (Hérité de Control.)
Méthode protégéeLoadControlStateRestaure les informations sur l'état du contrôle d'une demande de page précédente qui a été signalée par la méthode d' SaveControlState . (Hérité de Control.)
Méthode protégéeLoadPostDataLit les données de formulaire publiées à partir du navigateur sur le serveur et détermine la source de la publication (postback) asynchrone.
Méthode protégéeLoadViewStateRestaure les informations d'état d'affichage d'une demande de page précédente qui a été signalée par la méthode d' SaveViewState . (Hérité de Control.)
Méthode protégéeMapPathSecureRécupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, tables. (Hérité de Control.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode protégéeOnAsyncPostBackErrorDéclenche l'événement AsyncPostBackError.
Méthode protégéeOnBubbleEventDétermine si l'événement du contrôle serveur est passé en haut de la hiérarchie de contrôle de l'interface utilisateur de la page. (Hérité de Control.)
Méthode protégéeOnDataBindingDéclenche l'événement d' DataBinding . (Hérité de Control.)
Méthode protégéeOnInitDéclenche l'événement Init et s'assure qu'un seul contrôle ScriptManager existe sur la page. (Substitue Control.OnInit(EventArgs).)
Méthode protégéeOnLoadDéclenche l'événement d' Load . (Hérité de Control.)
Méthode protégéeOnPreRenderDéclenche l'événement PreRender et inscrit des fichiers de script et des services pour les mises à jour de pages partielles. (Substitue Control.OnPreRender(EventArgs).)
Méthode protégéeOnResolveCompositeScriptReferenceDéclenche l'événement ResolveCompositeScriptReference.
Méthode protégéeOnResolveScriptReferenceDéclenche l'événement d' ResolveScriptReference pour chaque référence de script qui est gérée par le contrôle d' ScriptManager .
Méthode protégéeOnUnloadDéclenche l'événement d' Unload . (Hérité de Control.)
Méthode protégéeOpenFileObtient Stream utilisé pour lire un fichier. (Hérité de Control.)
Méthode protégéeRaiseBubbleEventAssigne toutes les sources d'événement et ses informations au parent du contrôle. (Hérité de Control.)
Méthode protégéeRaisePostBackEventTraite un événement de publication (postback) déclenché par le contrôle ScriptManager et charge l'état de l'historique de la page Web.
Méthode protégéeRaisePostDataChangedEventDéclenche des événements pour le contrôle ScriptManager lors de la publication (postback) sur le serveur.
Méthode publiqueMembre statiqueRegisterArrayDeclaration(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.
Méthode publiqueMembre statiqueRegisterArrayDeclaration(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.
Méthode publiqueRegisterAsyncPostBackControlInscrit un contrôle comme déclencheur pour les publications (postback) asynchrones.
Méthode publiqueMembre statiqueRegisterClientScriptBlock(Control, Type, String, String, Boolean)Inscrit un bloc de script client avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l'intérieur d'un contrôle UpdatePanel, puis ajoute le bloc de script à la page.
Méthode publiqueMembre statiqueRegisterClientScriptBlock(Page, Type, String, String, Boolean)Inscrit un bloc de script client avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l'intérieur d'un contrôle UpdatePanel, puis ajoute le bloc de script à la page.
Méthode publiqueMembre statiqueRegisterClientScriptInclude(Control, Type, String, String)Inscrit un fichier de script client avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l'intérieur d'un contrôle UpdatePanel, puis ajoute une référence de fichier de script à la page.
Méthode publiqueMembre statiqueRegisterClientScriptInclude(Page, Type, String, String)Inscrit le script client avec le contrôle ScriptManager chaque fois qu'une publication (postback) asynchrone a lieu, puis ajoute une référence de fichier de script à la page.
Méthode publiqueMembre statiqueRegisterClientScriptResource(Control, Type, String)Inscrit le script client incorporé dans un assembly avec le contrôle ScriptManager pour une utilisation avec un contrôle qui participe au rendu de page partiel.
Méthode publiqueMembre statiqueRegisterClientScriptResource(Page, Type, String)Inscrit un fichier de script client incorporé dans un assembly avec le contrôle ScriptManager chaque fois qu'une publication (postback) a lieu.
Méthode publiqueRegisterDataItem(Control, String)Envoie des données personnalisées à un contrôle pendant le rendu de page partiel.
Méthode publiqueRegisterDataItem(Control, String, Boolean)Envoie des données personnalisées à un contrôle pendant le rendu de page partiel et indique si les données sont au format JSON (JavaScript Object Notation).
Méthode publiqueRegisterDisposeInscrit un script dispose pour un contrôle situé à l'intérieur d'un contrôle UpdatePanel. Le script est exécuté lorsque le contrôle UpdatePanel est mis à jour ou supprimé.
Méthode publiqueMembre statiqueRegisterExpandoAttributeInscrit une paire nom/valeur avec le contrôle ScriptManager en tant qu'attribut personnalisé (expando) d'un contrôle spécifié.
Méthode publiqueRegisterExtenderControl<TExtenderControl>Inscrit un contrôle d'extendeur avec l'instance ScriptManager en cours.
Méthode publiqueMembre statiqueRegisterHiddenField(Control, String, String)Inscrit un champ masqué avec le contrôle ScriptManager pour un contrôle situé à l'intérieur d'un contrôle UpdatePanel.
Méthode publiqueMembre statiqueRegisterHiddenField(Page, String, String)Inscrit un champ masqué avec le contrôle ScriptManager pendant chaque publication (postback) asynchrone.
Méthode publiqueMembre statiqueRegisterNamedClientScriptResource(Control, String)Inscrit le script client par nom de ressource, incorporé dans un assembly avec le contrôle ScriptManager pour une utilisation avec un contrôle qui participe au rendu de page partiel.
Méthode publiqueMembre statiqueRegisterNamedClientScriptResource(Page, String)Inscrit le script client par nom de ressource, incorporé dans un assembly avec le contrôle ScriptManager pour une utilisation avec un contrôle qui participe au rendu de page partiel.
Méthode publiqueMembre statiqueRegisterOnSubmitStatement(Control, Type, String, String)Inscrit le code ECMAScript (JavaScript) avec le contrôle ScriptManager pour un contrôle utilisé avec un contrôle UpdatePanel exécuté lorsque le formulaire est envoyé.
Méthode publiqueMembre statiqueRegisterOnSubmitStatement(Page, Type, String, String)Inscrit le code ECMAScript (JavaScript) avec le contrôle ScriptManager pour un contrôle utilisé avec un contrôle UpdatePanel exécuté lorsque le formulaire est envoyé.
Méthode publiqueRegisterPostBackControlInscrit un contrôle comme déclencheur pour une publication (postback). Cette méthode est utilisée pour configurer des contrôles de publication (postback)à l'intérieur d'un contrôle UpdatePanel qui, sinon, exécuterait des publications (postback) asynchrones.
Méthode publiqueRegisterScriptControl<TScriptControl>Inscrit un contrôle de script avec l'instance ScriptManager en cours.
Méthode publiqueRegisterScriptDescriptors(IExtenderControl)Rappelle une classe ExtenderControl pour retourner des scripts d'instance qui doivent être restitués pour prendre en charge l'objet client représentant un contrôle client, un composant ou un comportement.
Méthode publiqueRegisterScriptDescriptors(IScriptControl)Appelle une classe ScriptControl pour retourner des scripts d'instance qui doivent être restitués pour prendre en charge l'objet client représentant un contrôle client, un composant ou un comportement.
Méthode publiqueMembre statiqueRegisterStartupScript(Control, Type, String, String, Boolean)Inscrit un bloc de script de démarrage pour un contrôle situé à l'intérieur d'un UpdatePanel en utilisant le contrôle ScriptManager, et ajoute le bloc de script à la page.
Méthode publiqueMembre statiqueRegisterStartupScript(Page, Type, String, String, Boolean)Inscrit un bloc de script de démarrage pour chaque publication (postback) asynchrone avec le contrôle ScriptManager et ajoute le bloc de script à la page.
Méthode protégéeRemovedControlAppelé après un contrôle enfant est supprimé de la collection d' Controls de l'objet d' Control . (Hérité de Control.)
Méthode protégéeRenderRestitue le contenu du contrôle ScriptManager dans le navigateur à l'aide de l'objet HtmlTextWriter spécifié. (Substitue Control.Render(HtmlTextWriter).)
Méthode protégéeRenderChildrenRenvoie le contenu des enfants d'un contrôle serveur à un objet fourni d' HtmlTextWriter , qui écrit le contenu à afficher sur le client. (Hérité de Control.)
Méthode publiqueRenderControl(HtmlTextWriter)Renvoie le contenu de contrôle serveur à un objet fourni d' HtmlTextWriter et stocke les informations de traçage sur le contrôle s'il est activé. (Hérité de Control.)
Méthode protégéeRenderControl(HtmlTextWriter, ControlAdapter)Renvoie le contenu de contrôle serveur à un objet fourni d' HtmlTextWriter à l'aide d'un objet fourni d' ControlAdapter . (Hérité de Control.)
Méthode protégéeResolveAdapterObtient l'adaptateur de contrôle responsable de l'affichage du contrôle spécifié. (Hérité de Control.)
Méthode publiqueResolveClientUrlObtient une URL qui peut être utilisé par le navigateur. (Hérité de Control.)
Méthode publiqueResolveUrlConvertit une URL dans un utilisable sur le client demandeur. (Hérité de Control.)
Méthode protégéeSaveControlStateEnregistre toutes les modifications d'état de contrôle serveur qui se sont produites étant donné que le temps que la page a été publiée sur le serveur. (Hérité de Control.)
Méthode protégéeSaveViewStateEnregistre toutes les modifications de l'état d'affichage de contrôle serveur qui se sont produites étant donné que le temps que la page a été publiée sur le serveur. (Hérité de Control.)
Méthode protégéeSetDesignModeStateDéfinit les données au moment de le design pour un contrôle. (Hérité de Control.)
Méthode publiqueSetFocus(Control)Affecte au focus du navigateur le contrôle spécifié.
Méthode publiqueSetFocus(String)Affecte au focus du navigateur le contrôle spécifié par ID.
Méthode publiqueSetRenderMethodDelegateInfrastructure. Affecte un délégué de gestionnaire d'événements pour afficher le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control.)
Méthode publiqueSetTraceData(Object, Object)Définit les données de traçage pour le suivi au moment de le design des données de rendu, à l'aide de la clé de données de trace et la valeur des données de trace. (Hérité de Control.)
Méthode publiqueSetTraceData(Object, Object, Object)Définit les données de traçage pour le suivi au moment de le design des données de rendu, à l'aide de l'objet d'un suivi, la clé de données de traçage, et la valeur des données de trace. (Hérité de Control.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode protégéeTrackViewStateProvoque le suivi des modifications d'état d'affichage au contrôle serveur afin de pouvoir être stockés dans l'objet d' StateBag du contrôle serveur. Cet objet est accessible via la propriété d' Control.ViewState . (Hérité de Control.)
Début
  NomDescription
Événement publicAsyncPostBackErrorSe produit en cas d'erreur de page lors d'une publication (postback) asynchrone.
Événement publicDataBindingSe produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control.)
Événement publicDisposedSe produit lorsqu'un contrôle serveur est récupéré de la mémoire, qui est la dernière étape du cycle de vie du contrôle serveur où une page ASP.NET. est demandée. (Hérité de Control.)
Événement publicInitSe produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie. (Hérité de Control.)
Événement publicLoadSe produit lorsque le contrôle serveur est chargé dans l'objet d' Page . (Hérité de Control.)
Événement publicNavigateSe produit lorsque l'utilisateur clique sur le bouton Précédent ou Suivant du navigateur.
Événement publicPreRenderSe produit une fois que l'objet d' Control soit chargé mais avant le rendu. (Hérité de Control.)
Événement publicResolveCompositeScriptReferenceSe produit lorsqu'un script composite est inscrit auprès du contrôle ScriptManager.
Événement publicResolveScriptReferenceSe produit lorsqu'un membre de la collection Scripts est inscrit avec le contrôle ScriptManager.
Événement publicUnloadSe produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control.)
Début
  NomDescription
Méthode d'extension publiqueFindDataSourceControlRetourne la source de données associée au contrôle de données pour le contrôle spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueFindFieldTemplateRetourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. (Défini par DynamicDataExtensions.)
Méthode d'extension publiqueFindMetaTableRetourne l'objet Metatable pour le contrôle de données conteneur. (Défini par DynamicDataExtensions.)
Début
  NomDescription
Implémentation d'interface explicitePropriété privéeIControlBuilderAccessor.ControlBuilderPour obtenir une description de ce membre, consultez l' IControlBuilderAccessor.ControlBuilder. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.GetDesignModeStatePour obtenir une description de ce membre, consultez l' IControlDesignerAccessor.GetDesignModeState. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.SetDesignModeStatePour obtenir une description de ce membre, consultez l' IControlDesignerAccessor.SetDesignModeState. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIControlDesignerAccessor.SetOwnerControlInfrastructure. Pour obtenir une description de ce membre, consultez l' IControlDesignerAccessor.SetOwnerControl. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIControlDesignerAccessor.UserDataPour obtenir une description de ce membre, consultez l' IControlDesignerAccessor.UserData. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIDataBindingsAccessor.DataBindingsPour obtenir une description de ce membre, consultez l' IDataBindingsAccessor.DataBindings. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIDataBindingsAccessor.HasDataBindingsPour obtenir une description de ce membre, consultez l' IDataBindingsAccessor.HasDataBindings. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIExpressionsAccessor.ExpressionsPour obtenir une description de ce membre, consultez l' IExpressionsAccessor.Expressions. (Hérité de Control.)
Implémentation d'interface explicitePropriété privéeIExpressionsAccessor.HasExpressionsPour obtenir une description de ce membre, consultez l' IExpressionsAccessor.HasExpressions. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIParserAccessor.AddParsedSubObjectPour obtenir une description de ce membre, consultez l' IParserAccessor.AddParsedSubObject. (Hérité de Control.)
Implémentation d'interface expliciteMéthode privéeIPostBackDataHandler.LoadPostDataPour obtenir une description de ce membre, consultez IPostBackDataHandler.LoadPostData.
Implémentation d'interface expliciteMéthode privéeIPostBackDataHandler.RaisePostDataChangedEventPour obtenir une description de ce membre, consultez IPostBackDataHandler.RaisePostDataChangedEvent.
Implémentation d'interface expliciteMéthode privéeIPostBackEventHandler.RaisePostBackEventPermet au contrôle ScriptManager de traiter un événement de publication (postback) et de charger l'état de l'historique de la page Web.
Début

Dans cette rubrique :

Introduction

Le contrôle ScriptManager est essentiel aux fonctionnalités Ajax dans ASP.NET. Ce contrôle gère toutes les ressources ASP.NET Ajax sur une page. Cela inclut le téléchargement de scripts Microsoft Ajax Library vers le navigateur et la coordination des mises à jour de pages partielles activées à l'aide de contrôles UpdatePanel. De plus, le contrôle ScriptManager vous permet d'effectuer les opérations suivantes :

  • Inscrire le script qui est compatible avec des mises à jour de pages partielles. Pour gérer les dépendances entre votre script et la bibliothèque principale, tout script inscrit est chargé après le script Microsoft Ajax Library.

  • Spécifier si les scripts de version Release ou debug sont envoyés au navigateur.

  • Fournir l'accès aux méthodes de services Web du script en inscrivant les services Web avec le contrôle ScriptManager.

  • Fournir l'accès à l'authentification, au rôle et aux services d'application de profil ASP.NET à partir du script client en inscrivant ces services avec le contrôle ScriptManager.

  • Activer l'affichage spécifique à la culture des fonctions ECMAScript (JavaScript) Date, Nombre et Chaîne dans le navigateur.

  • Accéder aux ressources de localisation pour les fichiers de script incorporés ou pour les fichiers de script autonomes en utilisant la propriété ResourceUICultures du contrôle ScriptReference.

  • Inscrire des contrôles serveur qui implémentent les interfaces IExtenderControl ou IScriptControl avec le contrôle ScriptManager afin que le script requis par les composants clients et les comportements soit restitué.

Rendu de page partiel

La capacité d'une page ASP.NET à prendre en charge le rendu de page partiel est contrôlée par les facteurs suivants :

Vous pouvez substituer la valeur de la propriété EnablePartialRendering au moment de l'exécution pendant ou avant l'événement Init de la page. Si vous essayez de modifier cette propriété après l'événement Init de la page, une exception InvalidOperationException est levée.

Lorsque le rendu de page partiel est pris en charge, le contrôle ScriptManager restitue le script pour activer des publications (postbacks) asynchrones et des mises à jour de pages partielles. Les zones de la page à mettre à jour sont désignées à l'aide des contrôles UpdatePanel. Le contrôle ScriptManager gère les publications (postback) asynchrones et actualise uniquement les zones de la page qui doivent être mises à jour. Pour plus d'informations sur le rendu de page partielle, consultez Partial-Page Rendering Overview. Pour plus d'informations sur les conditions qui provoquent une mise à jour, consultez UpdatePanel Control Overview.

Utilisation du contrôle ScriptManager avec des pages maîtres, des contrôles utilisateur et d'autres composants enfants

Une page peut contenir un seul contrôle ScriptManager dans sa hiérarchie. Pour inscrire des services et des scripts pour des pages imbriquées, des contrôles utilisateur ou des composants lorsque la page parente a déjà un contrôle ScriptManager, utilisez le contrôle ScriptManagerProxy. Pour plus d’informations, voir Using the ASP.NET UpdatePanel Control with Master Pages.

Gestion et inscription de scripts

Le contrôle ScriptManager vous permet d'inscrire un script qui est ensuite restitué dans le cadre de la page. Les méthodes d'inscription de contrôle ScriptManager peuvent être réparties dans les trois catégories suivantes :

  • Méthodes d'inscription garantissant que les dépendances de script de Microsoft Ajax Library sont maintenues.

  • Méthodes d'inscription indépendantes de Microsoft Ajax Library, mais compatibles avec les contrôles UpdatePanel.

  • Méthodes d'inscription prenant en charge l'utilisation de contrôles UpdatePanel.

Pour plus d'informations sur la création et l'utilisation d'un script Ajax dans ASP.NET, consultez Creating Custom Client Scripts in ASP.NET AJAX.

Bb344905.collapse_all(fr-fr,VS.110).gifInscription d'un script dépendant de Microsoft Ajax Library

Vous pouvez utiliser les méthodes suivantes pour inscrire des fichiers de script d'une manière garantissant la conservation de toutes les dépendances de Microsoft Ajax Library. 

Méthode

Définition

RegisterScriptControl<TScriptControl>

Inscrit un contrôle serveur qui implémente l'interface IScriptControl utilisée pour définir un objet client Sys.Component. Le contrôle ScriptManager restitue un script qui prend en charge l'objet client.

RegisterExtenderControl<TExtenderControl>

Inscrit un contrôle serveur qui implémente l'interface IExtenderControl utilisée pour définir un objet client Sys.UI.Behavior. Le contrôle ScriptManager restitue un script qui prend en charge l'objet client.

Bb344905.collapse_all(fr-fr,VS.110).gifInscription de scripts compatibles avec la mise à jour de page partielle

Vous pouvez utiliser les méthodes suivantes pour inscrire des fichiers de script indépendants de Microsoft Ajax Library mais compatibles avec les contrôles UpdatePanel. Ces méthodes correspondent aux méthodes semblables du contrôle ClientScriptManager. Si vous restituez un script afin de l'utiliser dans un contrôle UpdatePanel, veillez à appeler les méthodes du contrôle ScriptManager.

Méthode

Définition

RegisterArrayDeclaration

Ajoute une valeur à un tableau JavaScript. Si le tableau n'existe pas, il est créé.

RegisterClientScriptBlock

Restitue un élément script après la balise d'ouverture <form> de la page. Le script est spécifié comme un paramètre de chaîne.

RegisterClientScriptInclude

Restitue un élément script après la balise d'ouverture <form> de la page. Le contenu du script est spécifié en affectant à l'attribut src une URL qui pointe vers un fichier de script.

RegisterClientScriptResource

Restitue un élément script après la balise d'ouverture <form> de la page. Le contenu du script est spécifié avec un nom de ressource dans un assembly. L'attribut src est automatiquement rempli avec une URL via un appel à un gestionnaire HTTP qui récupère le script nommé de l'assembly.

RegisterExpandoAttribute

Restitue une paire d'attribut nom/valeur personnalisée (un expando) dans le balisage pour un contrôle spécifié.

RegisterHiddenField

Restitue un champ masqué.

RegisterOnSubmitStatement

Inscrit un script exécuté en réponse à l'événement submit de l'élément form. L'attribut onSubmit référence le script spécifié.

RegisterStartupScript

Restitue un bloc de script de démarrage juste avant la balise de fermeture </form> de la page. Le script à restituer est spécifié comme un paramètre de chaîne.

Lorsque vous inscrivez des méthodes, vous spécifiez une paire type/clé pour ce script. Si un script avec la même paire type/clé est déjà inscrit, aucun nouveau script n'est inscrit. De la même façon, si vous inscrivez un script avec une paire type/nom de ressource qui existe déjà, l'élément script qui référence la ressource n'est plus ajouté. Lorsque vous inscrivez l'attribut expando d'un attribut précédemment inscrit, une exception est levée. L'inscription en double des valeurs de tableau est autorisée.

Lorsque vous appelez la méthode RegisterClientScriptInclude ou RegisterClientScriptResource, évitez d'inscrire un script qui exécute des fonctions inline. Inscrivez plutôt un script qui contient des définitions de fonction telles que des gestionnaires d'événements ou des définitions de classe personnalisée pour votre application.

Bb344905.collapse_all(fr-fr,VS.110).gifMéthodes d'inscription pour les contrôles UpdatePanel

Vous pouvez utiliser les méthodes suivantes pour personnaliser les mises à jour de pages partielles lorsque vous utilisez des contrôles UpdatePanel.

Méthode

Définition

RegisterAsyncPostBackControl

Inscrit un contrôle comme déclencheur pour les publications (postback) asynchrones.

RegisterDataItem

Envoie des données personnalisées aux contrôles pendant le rendu de page partiel.

RegisterDispose

Inscrit un script dispose pour un contrôle situé à l'intérieur d'un contrôle UpdatePanel. Le script est exécuté lorsque le contrôle UpdatePanel est mis à jour ou supprimé. La méthode dispose est utilisée pour les composants clients qui font partie de Microsoft Ajax Library et qui doivent libérer des ressources lorsqu'un composant n'est plus utilisé.

RegisterPostBackControl

Inscrit un contrôle comme déclencheur pour une publication (postback) complète. Cette méthode est utilisée pour les contrôles à l'intérieur d'un contrôle UpdatePanel qui, sinon, exécuteraient des publications (postback) asynchrones.

Références de service Web

Vous pouvez inscrire un service Web à appeler à partir du script client en créant un objet ServiceReference et en l'ajoutant à la collection Services du contrôle ScriptManager. ASP.NET génère un objet proxy client pour chaque objet ServiceReference de la collection Services. Vous pouvez ajouter par programme des objets ServiceReference à la collection Services pour inscrire des services Web au moment de l'exécution.

Pour plus d'informations sur l'accès aux services Web dans le script, consultez Exposing Web Services to Client Script in ASP.NET AJAX et Calling Web Services from Client Script in ASP.NET AJAX.

Localisation

Le contrôle ScriptManager génère des références dans la page rendue qui pointent vers les fichiers de script localisés appropriés, qui sont soit des fichiers de script incorporés dans des assemblys soit des fichiers de script autonomes.

Lorsque la propriété EnableScriptLocalization a la valeur true, le contrôle ScriptManager récupère des ressources localisées (telles que des chaînes localisées) pour la culture en cours, le cas échéant. Le contrôle ScriptManager fournit les fonctionnalités suivantes pour utiliser des ressources localisées :

  • Fichiers de script incorporés dans un assembly. Le contrôle ScriptManager détermine le fichier de script de culture de secours ou spécifique à la culture à envoyer au navigateur. Pour ce faire, il utilise l'attribut d'assembly NeutralResourcesLanguageAttribute spécifique à la culture, les ressources fournies avec l'assembly et la culture d'interface utilisateur du navigateur (le cas échéant).

  • Fichiers de script autonomes. Le contrôle ScriptManager définit la liste des cultures d'interface utilisateur prises en charge en utilisant la propriété ResourceUICultures de l'objet ScriptReference.

  • En mode débogage. Le contrôle ScriptManager essaie de restituer un fichier de script spécifique à la culture qui contient des informations de débogage. Par exemple, si la page est en mode débogage et si la culture en cours a la valeur en-MX, le contrôle restitue un fichier de script dont le nom est, par exemple, scriptname.en-MX.debug.js, si le fichier existe. Si le fichier n'existe pas, le fichier de débogage pour la culture de secours appropriée est restitué.

Pour plus d'informations sur la localisation des ressources, consultez Localizing Resources for Component Libraries Overview.

Gestion des erreurs

Lorsqu'une erreur de page se produit lors de publications (postback) asynchrones, l'événement AsyncPostBackError est déclenché. La façon dont les erreurs sur le serveur sont envoyées au client dépend de la propriété AllowCustomErrorsRedirect, de la propriété AsyncPostBackErrorMessage et de la section d'erreurs personnalisées du fichier Web.config. Pour plus d’informations, consultez Customizing Error Handling for ASP.NET UpdatePanel Controls.

Syntaxe déclarative

<asp:ScriptManager
    AllowCustomErrorsRedirect="True|False"
    AsyncPostBackErrorMessage="string"
    AsyncPostBackTimeout="integer"
    AuthenticationService-Path="uri"
    EnablePageMethods="True|False"
    EnablePartialRendering="True|False"
    EnableScriptGlobalization="True|False"
    EnableScriptLocalization="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    LoadScriptsBeforeUI="True|False"
    OnAsyncPostBackError="AsyncPostBackError event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnResolveScriptReference="ResolveScriptReference event handler"
    OnUnload="Unload event handler"
    ProfileService-LoadProperties="string"
    ProfileService-Path="uri"
    RoleService-LoadRoles="True|False"
    RoleService-Path="uri"
    runat="server"
    ScriptMode="Auto|Inherit|Debug|Release"
    ScriptPath="string"
    SkinID="string"
    SupportsPartialRendering="True|False"
    Visible="True|False"
>
        <AuthenticationService
            Path="uri"
        />
        <ProfileService
            LoadProperties="string"
            Path="uri"
        />
        <RoleService
            LoadRoles="True|False"
            Path="uri"
        />
        <Scripts>
            <asp:ScriptReference
                Assembly="string"
                IgnoreScriptPath="True|False"
                Name="string"
                NotifyScriptLoaded="True|False"
                Path="string"
                ResourceUICultures="string"
                ScriptMode="Auto|Debug|Inherit|Release"
            />
        </Scripts>
        <Services>
            <asp:ServiceReference
                InlineScript="True|False"
                Path="string"
            />
        </Services>
</asp:ScriptManager>
TopicLocation
Vue d'ensemble du contrôle UpdatePanelGénération d'applications Web ASP.NET dans Visual Studio
Vue d'ensemble du contrôle ScriptManagerGénération d'applications Web ASP.NET dans Visual Studio

Les exemples suivants affichent différents scénarios pour utiliser le contrôle ScriptManager.

Activation de mises à jour de pages partielles

L'exemple suivant indique comment utiliser le contrôle ScriptManager pour activer des mises à jour de pages partielles. Dans cet exemple, un contrôle Calendar et un contrôle DropDownList sont à l'intérieur d'un contrôle UpdatePanel. Par défaut, la valeur de la propriété UpdateMode est Always et la valeur de la propriété ChildrenAsTriggers est true. Par conséquent, les contrôles enfants du panneau entraînent une publication asynchrone.



<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    void DropDownSelection_Change(Object sender, EventArgs e)
    {
        Calendar1.DayStyle.BackColor =
            System.Drawing.Color.FromName(ColorList.SelectedItem.Value);
    }

    protected void Calendar1_SelectionChanged(object sender, EventArgs e)
    {
        SelectedDate.Text = 
            Calendar1.SelectedDate.ToString();
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
                               runat="server" />
            <asp:UpdatePanel ID="UpdatePanel1"
                             runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" 
                                  ShowTitle="True"
                                  OnSelectionChanged="Calendar1_SelectionChanged"
                                  runat="server" />
                    <div>
                        Background:
                        <br />
                        <asp:DropDownList ID="ColorList" 
                                          AutoPostBack="True" 
                                          OnSelectedIndexChanged="DropDownSelection_Change"
                                          runat="server">
                            <asp:ListItem Selected="True" Value="White"> 
                            White </asp:ListItem>
                            <asp:ListItem Value="Silver"> 
                            Silver </asp:ListItem>
                            <asp:ListItem Value="DarkGray"> 
                            Dark Gray </asp:ListItem>
                            <asp:ListItem Value="Khaki"> 
                            Khaki </asp:ListItem>
                            <asp:ListItem Value="DarkKhaki"> D
                            ark Khaki </asp:ListItem>
                        </asp:DropDownList>
                    </div>
                    <br />
                    Selected date:
                    <asp:Label ID="SelectedDate" 
                               runat="server">None.</asp:Label>
                </ContentTemplate>
            </asp:UpdatePanel>
            <br />
        </div>
    </form>
</body>
</html>


Gestion des erreurs de mise à jour de page partielle et inscription de script

L'exemple suivant montre comment fournir une gestion des erreurs personnalisée pendant les mises à jour de pages partielles. Par défaut, lorsqu'une erreur se produit pendant les mises à jour de pages partielles, un message JavaScript s'affiche. Cet exemple montre comment utiliser la gestion des erreurs personnalisée en fournissant un gestionnaire pour l'événement AsyncPostBackError et en définissant la propriété AsyncPostBackErrorMessage dans le gestionnaire d'événements. Vous pouvez également définir la propriété AllowCustomErrorsRedirect pour spécifier comment la section d'erreurs personnalisées du fichier Web.config est utilisée lorsqu'une erreur se produit pendant des mises à jour de pages partielles. Dans cet exemple, la valeur par défaut de la propriété AllowCustomErrorsRedirect est utilisée. Cela signifie que si le fichier Web.config contient un élément customErrors, cet élément détermine comment les erreurs s'affichent. Pour plus d’informations, consultez customErrors, élément (Schéma des paramètres ASP.NET).


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Button1_Click(object sender, EventArgs e)
    {
        try
        {
            int a = Int32.Parse(TextBox1.Text);
            int b = Int32.Parse(TextBox2.Text);
            int res = a / b;
            Label1.Text = res.ToString();
        }
        catch (Exception ex)
        {
            if (TextBox1.Text.Length > 0 && TextBox2.Text.Length > 0)
            {
                ex.Data["ExtraInfo"] = " You can't divide " +
                    TextBox1.Text + " by " + TextBox2.Text + ".";
            }
            throw ex;
        }
    }

    protected void ScriptManager1_AsyncPostBackError(object sender, AsyncPostBackErrorEventArgs e)
    {
        if (e.Exception.Data["ExtraInfo"] != null)
        {
            ScriptManager1.AsyncPostBackErrorMessage =
                e.Exception.Message +
                e.Exception.Data["ExtraInfo"].ToString();
        }
        else
        {
            ScriptManager1.AsyncPostBackErrorMessage =
                "An unspecified error occurred.";
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Error Handling Example</title>
    <style type="text/css">
    #UpdatePanel1 {
      width: 200px; height: 50px;
      border: solid 1px gray;
    }
    #AlertDiv{
    left: 40%; top: 40%;
    position: absolute; width: 200px;
    padding: 12px; 
    border: #000000 1px solid;
    background-color: white; 
    text-align: left;
    visibility: hidden;
    z-index: 99;
    }
    #AlertButtons{
    position: absolute; right: 5%; bottom: 5%;
    }
    </style>
</head>
<body id="bodytag">
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
            OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
            <Scripts>
            <asp:ScriptReference Path="ErrorHandling.js" />
            </Scripts>
            </asp:ScriptManager>
            <asp:UpdatePanel ID="UpdatePanel1" runat="server">
                <ContentTemplate>
                    <asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
                    /
                    <asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
                    =
                    <asp:Label ID="Label1" runat="server"></asp:Label><br />
                    <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
                </ContentTemplate>
            </asp:UpdatePanel>
            <div id="AlertDiv">
                <div id="AlertMessage">
                </div>
                <br />
                <div id="AlertButtons">
                    <input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
                </div>
            </div>
        </div>
    </form>
</body>
</html>


Globalisation de la date et de l'heure affichées dans le navigateur

L'exemple suivant montre comment définir la propriété EnableScriptGlobalization pour que le script client puisse afficher des date et heure spécifiques à la culture dans le navigateur. Dans l'exemple, l'attribut Culture de la directive @ Page a la valeur auto. Par conséquent, la première langue spécifiée dans les paramètres du navigateur en cours détermine la culture et la culture d'interface utilisateur pour la page. Pour plus d’informations, consultez How to: Set the Culture and UI Culture for ASP.NET Web Page Globalization.


<%@ Page Language="C#" Culture="auto" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>Globalization Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
        </asp:ScriptManager>
        <script type="text/javascript">
        function pageLoad() {
          Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
        }
        function formatDate() {
          var d = new Date();
          try {
            $get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
          }
          catch(e) {
            alert("Error:" + e.message);
          }
        }
        </script>
        <asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
        <ContentTemplate>
        <asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
        <asp:Button ID="Button1" runat="server" Text="Display Date" />

        <br />

        <asp:Label ID="Label1" runat="server"></asp:Label>
        </asp:Panel>
        </ContentTemplate>
        </asp:UpdatePanel>
    </form>
</body>
</html>


.NET Framework

Pris en charge dans : 4.5, 4, 3.5

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Cela vous a-t-il été utile ?
(1500 caractères restants)

Ajouts de la communauté

AJOUTER
© 2013 Microsoft. Tous droits réservés.