ScriptMode Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Spécifie si les objets ScriptManager et ScriptReference font référence à la version de débogage ou de mise en production des scripts clients.
public enum class ScriptModepublic enum ScriptModetype ScriptMode = Public Enum ScriptMode- Héritage
Champs
| Nom | Valeur | Description |
|---|---|---|
| Auto | 0 | Dans le ScriptManager contrôle, la version des scripts clients à utiliser est déterminée au moment de l’exécution en fonction de l’élément de compilation> au niveau< de l’application du fichier Web.config, sauf si elle est remplacée dans une instance du ScriptReference contrôle. Dans le ScriptReference contrôle, lorsqu’il est appliqué à un fichier de script autonome, Auto équivaut à Release. Lorsqu’elle est appliquée à une référence de script dans un assembly, Auto équivaut à Inherit. |
| Inherit | 1 | Dans le ScriptManager contrôle, Inherit équivaut à Auto. Dans le ScriptReference contrôle, la ScriptMode valeur à partir de ScriptManager laquelle déterminer la version du script client à utiliser. |
| Debug | 2 | Dans le ScriptManager contrôle, la version de débogage du script client est utilisée sur la page Web, sauf si elle est remplacée dans une instance du ScriptReference contrôle. Dans le ScriptReference contrôle, la version de débogage du script client est utilisée sur la page Web. |
| Release | 3 | Dans le ScriptManager contrôle, la version de mise en production du script client est utilisée sur la page Web, sauf si elle est remplacée par la définition de la ScriptMode propriété d’une ScriptReference instance Debugsur . Dans le ScriptReference contrôle, la version de mise en production du script client est utilisée sur la page Web. |
Exemples
L’exemple suivant montre une page dans laquelle les versions de script sont définies de manière déclarative sur Release dans le ScriptManager contrôle, mais un script nommé CustomClient.js est défini de manière déclarative sur Déboguer dans le Name contrôle.
<asp:ScriptManager ID="SM" runat="server" ScriptMode="Release">
<Scripts>
<asp:ScriptReference Path="CustomClient.js" ScriptMode="Debug" />
</Scripts>
</asp:ScriptManager>
<asp:ScriptManager ID="SM" runat="server" ScriptMode="Release">
<Scripts>
<asp:ScriptReference Path="CustomClient.js" ScriptMode="Debug" />
</Scripts>
</asp:ScriptManager>
Remarques
L’énumération ScriptMode fournit des valeurs pour définir la version du script client à utiliser sur une page Web. Les valeurs d’énumération peuvent être appliquées à la ScriptManager.ScriptMode propriété ou à la propriété ScriptReference.ScriptMode . L’objet ScriptManager définit la version de tous les scripts de la page, sauf si elle est remplacée par un ScriptReference objet. L’objet ScriptReference définit la version d’un script particulier.
La ScriptMode.Auto valeur produit des résultats différents selon qu’elle fait référence à un fichier de script autonome ou à un fichier de script incorporé en tant que ressource dans un assembly. Un fichier de script autonome est défini avec la propriété ScriptReference.Path . Une référence d’assembly doit être accessible via les propriétés et Assembly les Name propriétés. Les résultats de la ScriptMode.Auto valeur sont les suivants :
Lorsqu’elle est appliquée à un fichier de script autonome où la propriété [ScriptReference.Path]Path est spécifiée, la ScriptMode.Auto valeur est équivalente à ScriptMode.Release.
Lorsqu’elle est appliquée à une référence de script dans un assembly, ScriptMode.Auto équivaut à ScriptMode.Inherit. Lorsqu’il est spécifié uniquement Name , il est utilisé pour référencer le script. Quand Name et la propriété [ScriptReference.Path]Path sont spécifiées, la propriété [ScriptReference.Path]Path est utilisée au lieu de Name, mais la ScriptMode.Auto valeur est toujours équivalente à ScriptMode.Inherit.
Une erreur est levée si la version demandée du script n’existe pas. Par exemple, une erreur est levée si une référence est faite à un fichier de script autonome nommé CustomScript.js et que la ScriptManager.ScriptMode propriété est définie ScriptMode.Debugsur , mais CustomScript.debug.js n’existe pas sur le site. Les références aux scripts d’un assembly retournent la version de mise en production si la version de débogage n’existe pas.
Note
Lorsque l’attribut retail de l’élément de déploiement du fichier Machine.config est défini truesur , les versions de mise en production des scripts clients sont utilisées dans tout le site Web. Les ScriptMode valeurs des ScriptManager.ScriptMode propriétés ScriptReference.ScriptMode et ScriptReference.ScriptMode sont ignorées.
