Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

ScriptMode-Enumeration

 

Veröffentlicht: Juli 2016

Gibt an, ob ScriptManager- und ScriptReference-Objekte sich auf die Debug- oder endgültige Produktversion des Clientskripts beziehen.

Namespace:   System.Web.UI
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

public enum ScriptMode

MembernameBeschreibung
Auto

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. Im ScriptReference-Steuerelement entspricht Auto bei Anwendung auf eine eigenständige Skriptdatei Release. Bei Anwendung auf einen Skriptverweis in einer Assembly entspricht AutoInherit.

Debug

Im ScriptManager-Steuerelement wird die Debugversion des Clientskripts auf der Webseite verwendet, sofern es nicht in einer Instanz des ScriptReference-Steuerelements überschrieben wird. Im ScriptReference-Steuerelement wird die Debugversion des Clientskripts auf der Webseite verwendet.

Inherit

Im ScriptManager-Steuerelement entspricht InheritAuto. Im ScriptReference-Steuerelement bestimmt der ScriptMode-Wert aus ScriptManager, welche Version des Clientskripts verwendet wird.

Release

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. Im ScriptReference-Steuerelement wird die endgültige Produktversion des Clientskripts auf der Webseite verwendet.

The T:System.Web.UI.ScriptMode enumerator provides values for setting which version of client script to use on a Web page. The enumerator values can be applied to either the P:System.Web.UI.ScriptManager.ScriptMode property of the T:System.Web.UI.ScriptManager object, or to the P:System.Web.UI.ScriptReference.ScriptMode property of the T:System.Web.UI.ScriptReference object. The T:System.Web.UI.ScriptManager object sets the version for all scripts on the page unless it is overridden by a T:System.Web.UI.ScriptReference object. The T:System.Web.UI.ScriptReference object sets the version for a particular script.

The F:System.Web.UI.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. A standalone script file is defined with the P:System.Web.UI.ScriptReference.Path property. An assembly reference must be accessed through the P:System.Web.UI.ScriptReference.Name and P:System.Web.UI.ScriptReference.Assembly properties. The results for the F:System.Web.UI.ScriptMode.Auto value are as follows:

  • When it is applied to a standalone script file where the P:System.Web.UI.ScriptReference.Path property is specified, the F:System.Web.UI.ScriptMode.Auto value is equivalent to F:System.Web.UI.ScriptMode.Release.

  • When it is applied to a script reference in an assembly, F:System.Web.UI.ScriptMode.Auto is equivalent to F:System.Web.UI.ScriptMode.Inherit. When only P:System.Web.UI.ScriptReference.Name is specified, it is used to reference the script. When P:System.Web.UI.ScriptReference.Name and the P:System.Web.UI.ScriptReference.Path property are both specified, the P:System.Web.UI.ScriptReference.Path property is used instead of P:System.Web.UI.ScriptReference.Name, but the F:System.Web.UI.ScriptMode.Auto value is still equivalent to F:System.Web.UI.ScriptMode.Inherit.

An error is thrown if the requested version of the script does not exist. For instance, an error is thrown if a reference is made to a standalone script file that is named CustomScript.js and T:System.Web.UI.ScriptMode is set to F:System.Web.UI.ScriptMode.Debug, but CustomScript.debug.js does not exist on the site. References to scripts in an assembly return the release version if the debug version does not exist.

System_CAPS_noteHinweis

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. The T:System.Web.UI.ScriptMode values in the T:System.Web.UI.ScriptManager and T:System.Web.UI.ScriptReference properties are ignored.

The following example shows a page where the script versions are declaratively set to F:System.Web.UI.ScriptMode.Release in the T:System.Web.UI.ScriptManager control, but one script named CustomClient.js is declaratively set to F:System.Web.UI.ScriptMode.Debug in the T:System.Web.UI.ScriptReference control.

<asp:ScriptManager ID="SM" runat="server" ScriptMode="Release">
    <Scripts>
        <asp:ScriptReference Path="CustomClient.js" ScriptMode="Debug" />
    </Scripts>
</asp:ScriptManager>

.NET Framework
Verfügbar seit 3.5
Zurück zum Anfang
Anzeigen: