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 commerciale des scripts clients.
public enum class ScriptModepublic enum ScriptModetype ScriptMode = Public Enum ScriptMode- Héritage
Champs
| Auto | 0 | Dans le contrôle ScriptManager, la version des scripts clients à utiliser est déterminée au moment de l’exécution en fonction de l’élément <compilation> au niveau de l’application du fichier Web.config, sauf si elle est substituée dans une instance du contrôle ScriptReference. Dans le contrôle ScriptReference, lorsqu’il est appliqué à un fichier de script autonome, Auto équivaut à Release. Lorsqu’il est appliqué à une référence de script dans un assembly, Auto équivaut à Inherit. |
| Debug | 2 | Dans le contrôle ScriptManager, la version de débogage du script client est utilisée sur la page Web, sauf si elle est substituée dans une instance du contrôle ScriptReference. Dans le contrôle ScriptReference, la version de débogage du script client est utilisée sur la page Web. |
| Inherit | 1 | Dans le ScriptManager contrôle, Inherit équivaut à Auto. Dans le ScriptReference contrôle, la ScriptMode valeur de ScriptManager détermine la version du script client à utiliser. |
| Release | 3 | Dans le contrôle ScriptManager, la version commerciale du script client est utilisée sur la page Web, sauf si elle est substituée par la définition de la propriété ScriptMode dans une instance ScriptReference sur Debug . Dans le contrôle ScriptReference, la version commerciale 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 Name propriétés et Assembly . 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 équivaut à ScriptMode.Release.
Lorsqu’elle est appliquée à une référence de script dans un assembly, ScriptMode.Auto équivaut à ScriptMode.Inherit. Quand est spécifié uniquement Name , il est utilisé pour référencer le script. Lorsque Name et la propriété [ScriptReference.Path]Path sont tous deux spécifiés, 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 générée si la version demandée du script n’existe pas. Par exemple, une erreur est générée si une référence est faite à un fichier de script autonome nommé CustomScript.js et que la propriété a la ScriptManager.ScriptModeScriptMode.Debugvaleur , mais CustomScript.debug.js n’existe pas sur le site. Les références aux scripts dans un assembly retournent la version de mise en production si la version de débogage n’existe pas.
Notes
Lorsque l’attribut retail de l’élément de déploiement du fichier Machine.config est défini sur true, les versions de mise en production des scripts clients sont utilisées dans le site web. Les ScriptMode valeurs des ScriptManager.ScriptMode propriétés et ScriptReference.ScriptMode sont ignorées.
