ScriptMode Enum
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee geeft u op of ScriptManager en ScriptReference objecten verwijzen naar de foutopsporing of releaseversie van clientscripts.
public enum class ScriptModepublic enum ScriptModetype ScriptMode = Public Enum ScriptMode- Overname
Velden
| Name | Waarde | Description |
|---|---|---|
| Auto | 0 | In het ScriptManager besturingselement wordt de te gebruiken versie van clientscripts tijdens runtime bepaald op basis van het compilatie-element> op toepassingsniveau< van het Web.config bestand, tenzij deze wordt overschreven in een exemplaar van het ScriptReference besturingselement. Wanneer het ScriptReference besturingselement wordt toegepast op een zelfstandig scriptbestand, Auto is dit gelijk aan Release. Wanneer deze wordt toegepast op een scriptreferentie in een assembly, Auto is dit gelijk aan Inherit. |
| Inherit | 1 | In het ScriptManager besturingselement is Inherit dit gelijk aan Auto. In het ScriptReference besturingselement bepaalt de ScriptMode waarde van ScriptManager welke versie van het clientscript moet worden gebruikt. |
| Debug | 2 | In het ScriptManager besturingselement wordt de foutopsporingsversie van het clientscript gebruikt op de webpagina, tenzij deze wordt overschreven in een exemplaar van het ScriptReference besturingselement. In het ScriptReference besturingselement wordt de foutopsporingsversie van het clientscript gebruikt op de webpagina. |
| Release | 3 | In het ScriptManager besturingselement wordt de releaseversie van het clientscript gebruikt op de webpagina, tenzij deze wordt overschreven door de ScriptMode eigenschap van een ScriptReference exemplaar in te stellen op Debug. In het ScriptReference besturingselement wordt de releaseversie van het clientscript gebruikt op de webpagina. |
Voorbeelden
In het volgende voorbeeld ziet u een pagina waarop de scriptversies declaratief zijn ingesteld op Vrijgeven in het ScriptManager besturingselement, maar één script met de naam CustomClient.js declaratief is ingesteld op Foutopsporing in het Name besturingselement.
<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>
Opmerkingen
De ScriptMode opsomming bevat waarden voor het instellen van de versie van het clientscript die moet worden gebruikt op een webpagina. De opsommingswaarden kunnen worden toegepast op de ScriptManager.ScriptMode eigenschap of op de eigenschap ScriptReference.ScriptMode . Het ScriptManager object stelt de versie in voor alle scripts op de pagina, tenzij deze door een ScriptReference object wordt overschreven. Met ScriptReference het object wordt de versie voor een bepaald script ingesteld.
De ScriptMode.Auto waarde produceert verschillende resultaten, afhankelijk van of deze verwijst naar een zelfstandig scriptbestand of naar een scriptbestand dat is ingesloten als een resource in een assembly. Er wordt een zelfstandig scriptbestand gedefinieerd met de eigenschap ScriptReference.Path . Een assembly-verwijzing moet worden geopend via de Name en Assembly eigenschappen. De resultaten voor de ScriptMode.Auto waarde zijn als volgt:
Wanneer deze wordt toegepast op een zelfstandig scriptbestand waarin de eigenschap [ScriptReference.Path]Path is opgegeven, is de ScriptMode.Auto waarde gelijk aan ScriptMode.Release.
Wanneer deze wordt toegepast op een scriptreferentie in een assembly, ScriptMode.Auto is dit gelijk aan ScriptMode.Inherit. Wanneer alleen Name wordt opgegeven, wordt deze gebruikt om te verwijzen naar het script. Wanneer Name en de eigenschap [ScriptReference.Path]Path beide zijn opgegeven, wordt de eigenschap [ScriptReference.Path]Path gebruikt in plaats van Name, maar de ScriptMode.Auto waarde is nog steeds gelijk aan ScriptMode.Inherit.
Er wordt een fout gegenereerd als de aangevraagde versie van het script niet bestaat. Er wordt bijvoorbeeld een fout gegenereerd als er een verwijzing wordt gemaakt naar een zelfstandig scriptbestand met de naam CustomScript.js en de ScriptManager.ScriptMode eigenschap is ingesteld ScriptMode.Debugop , maar CustomScript.debug.js niet op de site bestaat. Verwijzingen naar scripts in een assembly retourneren de releaseversie als de foutopsporingsversie niet bestaat.
Note
Wanneer het retail kenmerk van het implementatie-element van het Machine.config-bestand is ingesteld trueop, worden de releaseversies van clientscripts overal op de website gebruikt. De ScriptMode waarden in de ScriptManager.ScriptMode eigenschappen ScriptReference.ScriptMode worden genegeerd.