ScriptMode ScriptMode ScriptMode ScriptMode Enum

Definition

Gibt an, ob ScriptManager- und ScriptReference-Objekte sich auf die Debug- oder endgültige Produktversion des Clientskripts beziehen.Specifies whether ScriptManager and ScriptReference objects refer to the debug or release version of client scripts.

public enum class ScriptMode
public enum ScriptMode
type ScriptMode = 
Public Enum ScriptMode
Vererbung

Felder

Auto Auto Auto Auto 0

Im ScriptManager-Steuerelement wird die Version des zu verwendenden Clientskripts zur Laufzeit basierend auf dem Anwendungsebenen-<compilation>-Element der Web.config-Datei bestimmt – es sei denn, sie wird in einer Instanz des ScriptReference-Steuerelements überschrieben.In the ScriptManager control, the version of client scripts to use is determined at run time based on the application-level <compilation> element of the Web.config file, unless it is overridden in an instance of the ScriptReference control. Im ScriptReference-Steuerelement entspricht Auto bei Anwendung auf eine eigenständige Skriptdatei Release.In the ScriptReference control, when applied to a standalone script file, Auto is equivalent to Release. Bei Anwendung auf einen Skriptverweis in einer Assembly entspricht Auto Inherit.When applied to a script reference in an assembly, Auto is equivalent to Inherit.

Debug Debug Debug Debug 2

Im ScriptManager-Steuerelement wird die Debugversion des Clientskripts auf der Webseite verwendet, sofern es nicht in einer Instanz des ScriptReference-Steuerelements überschrieben wird.In the ScriptManager control, the debug version of the client script is used on the Web page unless overridden in an instance of the ScriptReference control. Im ScriptReference-Steuerelement wird die Debugversion des Clientskripts auf der Webseite verwendet.In the ScriptReference control, the debug version of the client script is used on the Web page.

Inherit Inherit Inherit Inherit 1

Im ScriptManager-Steuerelement entspricht Inherit Auto.In the ScriptManager control, Inherit is equivalent to Auto. Im ScriptReference-Steuerelement bestimmt der ScriptMode-Wert aus ScriptManager, welche Version des Clientskripts verwendet wird.In the ScriptReference control, the ScriptMode value from ScriptManager determines which version of the client script to use.

Release Release Release Release 3

Im ScriptManager-Steuerelement wird die endgültige Produktversion des Clientskripts auf der Webseite verwendet, sofern es nicht durch Einstellung der ScriptMode-Eigenschaft einer ScriptReference-Instanz zu Debug überschrieben wird.In the ScriptManager control, the release version of the client script is used on the Web page unless overridden by setting the ScriptMode property of a ScriptReference instance to Debug. Im ScriptReference-Steuerelement wird die endgültige Produktversion des Clientskripts auf der Webseite verwendet.In the ScriptReference control, the release version of the client script is used on the Web page.

Beispiele

Das folgende Beispiel zeigt eine Seite, auf der die Skript Versionen deklarativ auf Release im ScriptManager -Steuerelement festgelegt sind. ein Skript mit dem Namen "CustomClient. js" ist jedoch deklarativ auf Debug Name im-Steuerelement festgelegt.The following example shows a page where the script versions are declaratively set to Release in the ScriptManager control, but one script named CustomClient.js is declaratively set to Debug in the Name control.

<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>

Hinweise

Die ScriptMode -Enumeration stellt Werte zum Festlegen der Version des Client Skripts bereit, die auf einer Webseite verwendet werden soll.The ScriptMode enumeration provides values for setting the version of client script to use on a Web page. Die Enumerationswerte können entweder auf die ScriptManager.ScriptMode -Eigenschaft oder die scriptreferen. ScriptMode -Eigenschaft angewendet werden.The enumeration values can be applied to either the ScriptManager.ScriptMode property or to the ScriptReference.ScriptMode property. Das ScriptManager -Objekt legt die Version für alle Skripts auf der Seite fest, es sei denn ScriptReference , Sie wird von einem-Objekt überschrieben.The ScriptManager object sets the version for all scripts on the page unless it is overridden by a ScriptReference object. Das ScriptReference -Objekt legt die Version für ein bestimmtes Skript fest.The ScriptReference object sets the version for a particular script.

Der ScriptMode.Auto Wert führt zu unterschiedlichen Ergebnissen, abhängig davon, ob er auf eine eigenständige Skriptdatei oder auf eine Skriptdatei verweist, die als Ressource in einer Assembly eingebettet ist.The ScriptMode.Auto value produces different results depending on whether it refers to a standalone script file or to a script file that is embedded as a resource in an assembly. Eine eigenständige Skriptdatei wird mit der scriptreferen. Path -Eigenschaft definiert.A standalone script file is defined with the ScriptReference.Path property. Auf einen Assemblyverweis muss über Name die Assembly -und-Eigenschaften zugegriffen werden.An assembly reference must be accessed through the Name and Assembly properties. Die Ergebnisse für den ScriptMode.Auto Wert lauten wie folgt:The results for the ScriptMode.Auto value are as follows:

Wenn die angeforderte Version des Skripts nicht vorhanden ist, wird ein Fehler ausgegeben.An error is thrown if the requested version of the script does not exist. Beispielsweise wird ein Fehler ausgelöst, wenn ein Verweis auf eine eigenständige Skriptdatei mit dem Namen "CustomScript. js" und ScriptManager.ScriptMode die-Eigenschaft auf ScriptMode.Debugfestgelegt wird, "CustomScript. Debug. js" jedoch nicht auf der Website vorhanden ist.For instance, an error is thrown if a reference is made to a standalone script file that is named CustomScript.js and the ScriptManager.ScriptMode property is set to ScriptMode.Debug, but CustomScript.debug.js does not exist on the site. Verweise auf Skripts in einer Assembly geben die Releaseversion zurück, wenn die Debugversion nicht vorhanden ist.References to scripts in an assembly return the release version if the debug version does not exist.

Hinweis

Wenn das retail -Attribut des Deployment -Elements der Datei Machine. config auf festgelegt trueist, werden die Releaseversionen von Client Skripts auf der gesamten Website verwendet.When the retail attribute of the deployment element of the Machine.config file is set to true, the release versions of client scripts are used throughout the Web site. Die ScriptMode Werte in der ScriptManager.ScriptMode -Eigenschaft und der scriptreferen. ScriptMode -Eigenschaft werden ignoriert.The ScriptMode values in the ScriptManager.ScriptMode and ScriptReference.ScriptMode properties are ignored.

Gilt für: