ScriptMode Enumeration
Definition
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 auf die Debug- oder Releaseversion von Clientskripts verweisen.
public enum class ScriptModepublic enum ScriptModetype ScriptMode = Public Enum ScriptMode- Vererbung
Felder
| Name | Wert | Beschreibung |
|---|---|---|
| Auto | 0 | ScriptManager Im Steuerelement wird die zu verwendende Version von Clientskripts zur Laufzeit basierend auf dem Kompilierungselement> der Web.config-Datei auf Anwendungsebene< bestimmt, es sei denn, sie wird in einer Instanz des ScriptReference Steuerelements außer Kraft gesetzt. Wenn das ScriptReference Steuerelement auf eine eigenständige Skriptdatei angewendet wird, Auto entspricht das ReleaseSteuerelement . Wenn sie auf einen Skriptverweis in einer Assembly angewendet wird, Auto entspricht es Inherit. |
| Inherit | 1 | ScriptManager Im Steuerelement Inherit entspricht es Auto. ScriptReference Im Steuerelement bestimmt der ScriptMode Wert, aus ScriptManager welcher Version des Clientskripts verwendet werden soll. |
| Debug | 2 | ScriptManager Im Steuerelement wird die Debugversion des Clientskripts auf der Webseite verwendet, es sei denn, sie wird in einer Instanz des ScriptReference Steuerelements außer Kraft gesetzt. ScriptReference Im Steuerelement wird die Debugversion des Clientskripts auf der Webseite verwendet. |
| Release | 3 | ScriptManager Im Steuerelement wird die Releaseversion des Clientskripts auf der Webseite verwendet, es sei denn, die Eigenschaft einer ScriptReference Instanz wird ScriptMode überschrieben.Debug ScriptReference Im Steuerelement wird die Releaseversion 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 Enumeration stellt Werte zum Festlegen der Clientskriptversion bereit, 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 er sich auf eine eigenständige Skriptdatei oder auf eine Skriptdatei bezieht, die als Ressource in einer Assembly eingebettet ist. Eine eigenständige Skriptdatei wird mit der ScriptReference.Path-Eigenschaft definiert. Auf einen Assemblyverweis muss über die und Assembly die Name Eigenschaften zugegriffen 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 ist, entspricht ScriptMode.Releaseder ScriptMode.Auto Wert .
Wenn es auf einen Skriptverweis in einer Assembly angewendet wird, ScriptMode.Auto entspricht es ScriptMode.Inherit. Wenn nur Name angegeben wird, wird es verwendet, um auf das Skript zu verweisen. Wenn Name und die [ScriptReference.Path]Path -Eigenschaft beide angegeben sind, wird die [ScriptReference.Path]Path -Eigenschaft anstelle von Name, aber der ScriptMode.Auto Wert entspricht weiterhin ScriptMode.Inherit.
Wenn die angeforderte Version des Skripts nicht vorhanden ist, wird ein Fehler ausgelöst. Beispielsweise wird ein Fehler ausgelöst, wenn ein Verweis auf eine eigenständige Skriptdatei mit dem Namen CustomScript.js erfolgt und die ScriptManager.ScriptMode Eigenschaft auf ScriptMode.Debug", aber CustomScript.debug.js auf der Website nicht vorhanden ist. Verweise auf Skripts in einer Assembly geben die Releaseversion zurück, wenn die Debugversion nicht vorhanden ist.
Hinweis
Wenn das retail Attribut des Bereitstellungselements der Machine.config Datei auf "festgelegt" festgelegt trueist, werden die Versionsversionen von Clientskripts auf der gesamten Website verwendet. Die ScriptMode Werte in den ScriptManager.ScriptModeEigenschaften ScriptReference.ScriptMode werden ignoriert.
