ScriptMode Enumeration

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public enum class ScriptMode

public enum ScriptMode

type ScriptMode =

Public Enum ScriptMode

Vererbung: Object

ValueType

Enum
ScriptMode

Felder

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. Im ScriptReference-Steuerelement entspricht Auto bei Anwendung auf eine eigenständige Skriptdatei Release. Bei Anwendung auf einen Skriptverweis in einer Assembly entspricht Auto Inherit.
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. Im ScriptReference-Steuerelement wird die Debugversion des Clientskripts auf der Webseite verwendet.
Inherit	1	Im ScriptManager-Steuerelement entspricht Inherit Auto. Im ScriptReference-Steuerelement bestimmt der ScriptMode-Wert aus ScriptManager, welche Version des Clientskripts verwendet wird.
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. Im ScriptReference-Steuerelement wird die endgültige Produktversion des Clientskripts auf der Webseite verwendet.

Beispiele

Das folgende Beispiel zeigt eine Seite, auf der die Skriptversionen deklarativ auf "Release" im ScriptManager Steuerelement festgelegt sind, aber ein Skript mit dem Namen "CustomClient.js" wird deklarativ auf "Debuggen" im Name Steuerelement festgelegt.

<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 Aufzählung stellt Werte bereit, um die Version des Clientskripts festzulegen, die auf einer Webseite verwendet werden soll. Die Enumerationswerte können entweder auf die ScriptManager.ScriptMode Eigenschaft oder auf die ScriptReference.ScriptMode-Eigenschaft angewendet werden. Das ScriptManager Objekt legt die Version für alle Skripts auf der Seite fest, es sei denn, es wird von einem ScriptReference Objekt außer Kraft gesetzt. Das ScriptReference Objekt legt die Version für ein bestimmtes Skript fest.

Der ScriptMode.Auto Wert erzeugt unterschiedliche Ergebnisse, je nachdem, ob es sich auf eine eigenständige Skriptdatei oder auf eine Skriptdatei bezieht, die als Ressource in eine Assembly eingebettet ist. Eine eigenständige Skriptdatei wird mit der ScriptReference.Path-Eigenschaft definiert. Auf einen Assemblyverweis muss über die Name Eigenschaften zugegriffen Assembly werden. Die Ergebnisse für den ScriptMode.Auto Wert sind wie folgt:

Wenn sie auf eine eigenständige Skriptdatei angewendet wird, in der die [ScriptReference.Path]Path-Eigenschaft angegeben wird, entspricht ScriptMode.Releaseder ScriptMode.Auto Wert .
Wenn er auf einen Skriptverweis in einer Assembly angewendet wird, ScriptMode.Auto entspricht ScriptMode.Inherites . Wenn nur Name angegeben wird, wird es verwendet, um auf das Skript zu verweisen. Wenn Name und die [ScriptReference.Path]Path -Eigenschaft angegeben sind, wird die [ScriptReference.Path]Path -Eigenschaft anstelle von Nameverwendet, aber der ScriptMode.Auto Wert entspricht weiterhin ScriptMode.Inherit.

Ein Fehler wird ausgelöst, wenn die angeforderte Version des Skripts nicht vorhanden ist. Beispielsweise wird ein Fehler ausgelöst, wenn ein Verweis auf eine eigenständige Skriptdatei ausgeführt wird, die CustomScript.js benannt ist, und die ScriptManager.ScriptMode Eigenschaft auf ScriptMode.Debug", aber CustomScript.debug.js ist nicht auf der Website vorhanden. Verweise auf Skripts in einer Assembly geben die Version der Version zurück, wenn die Debugversion nicht vorhanden ist.

Hinweis

Wenn das retail Attribut des Bereitstellungselements der Machine.config-Datei auf truefestgelegt ist, werden die Versionsversionen von Clientskripts auf der gesamten Website verwendet. Die ScriptMode Werte in den ScriptManager.ScriptMode Eigenschaften ScriptReference.ScriptMode werden ignoriert.

Gilt für