ScriptMode Wyliczenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Określa, czy ScriptManager obiekty i ScriptReference odwołują się do wersji debugowania lub wydania skryptów klienta.
public enum class ScriptMode
public enum ScriptMode
type ScriptMode =
Public Enum ScriptMode
- Dziedziczenie
Pola
Auto | 0 | W kontrolce ScriptManager wersja skryptów klienta do użycia jest określana w czasie wykonywania na podstawie elementu kompilacji> na poziomie< aplikacji pliku Web.config, chyba że zostanie zastąpiona w wystąpieniu kontrolkiScriptReference. W kontrolce po zastosowaniu ScriptReference do autonomicznego pliku Auto skryptu jest odpowiednikiem Release. Zastosowanie do odwołania do skryptu w zestawie Auto jest równoważne Inherit. |
Debug | 2 | W kontrolce ScriptManager wersja debugowania skryptu klienta jest używana na stronie sieci Web, chyba że zostanie zastąpiona w wystąpieniu kontrolki ScriptReference . W kontrolce ScriptReference wersja debugowania skryptu klienta jest używana na stronie sieci Web. |
Inherit | 1 | W kontrolce ScriptManager Inherit jest odpowiednikiem Auto. W kontrolce ScriptReference wartość z ScriptManager określa, ScriptMode która wersja skryptu klienta ma być używana. |
Release | 3 | W kontrolce ScriptManager wersja wydania skryptu klienta jest używana na stronie sieci Web, chyba że zostanie zastąpiona przez ustawienie ScriptMode właściwości ScriptReference wystąpienia na Debug. W kontrolce ScriptReference wersja wydania skryptu klienta jest używana na stronie sieci Web. |
Przykłady
W poniższym przykładzie pokazano stronę, na której wersje skryptów są deklaratywne ustawione na Wydanie w kontrolce ScriptManager , ale jeden skrypt o nazwie CustomClient.js jest deklaratywnie ustawiony na Debuguj w kontrolce Name .
<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>
Uwagi
Wyliczenie ScriptMode zawiera wartości służące do ustawiania wersji skryptu klienta do użycia na stronie sieci Web. Wartości wyliczenia można zastosować do ScriptManager.ScriptMode właściwości lub do właściwości ScriptReference.ScriptMode . Obiekt ScriptManager ustawia wersję wszystkich skryptów na stronie, chyba że zostanie zastąpiony przez ScriptReference obiekt. Obiekt ScriptReference ustawia wersję określonego skryptu.
Wartość ScriptMode.Auto generuje różne wyniki w zależności od tego, czy odwołuje się do autonomicznego pliku skryptu, czy do pliku skryptu osadzonego jako zasób w zestawie. Autonomiczny plik skryptu jest definiowany z właściwością ScriptReference.Path . Dostęp do odwołania do zestawu należy uzyskać za pośrednictwem Name właściwości i Assembly . Wyniki dla ScriptMode.Auto wartości są następujące:
Po zastosowaniu go do pliku skryptu autonomicznego, w którym określono ScriptMode.Auto właściwość [ScriptReference.Path],Path wartość jest równoważna ScriptMode.Release.
Gdy jest on stosowany do odwołania do skryptu w zestawie, ScriptMode.Auto jest odpowiednikiem ScriptMode.Inherit. Po określeniu jest Name on używany do odwołowania się do skryptu. Gdy Name właściwość [ScriptReference.Path] jest określona, właściwość [ScriptReference.Path]PathPath jest używana zamiast Name, ale ScriptMode.Auto wartość jest nadal równoważna ScriptMode.Inherit.
Jeśli żądana wersja skryptu nie istnieje, zostanie zgłoszony błąd. Na przykład błąd jest zgłaszany, jeśli odwołanie jest wykonywane do autonomicznego pliku skryptu o nazwie CustomScript.js, a ScriptManager.ScriptMode właściwość jest ustawiona na ScriptMode.Debug, ale CustomScript.debug.js nie istnieje w witrynie. Odwołania do skryptów w zestawie zwracają wersję wydania, jeśli wersja debugowania nie istnieje.
Uwaga
Gdy retail
atrybut elementu wdrożenia pliku Machine.config jest ustawiony na true
, wersje wydań skryptów klienta są używane w całej witrynie sieci Web. ScriptMode Wartości we właściwościach ScriptManager.ScriptMode ScriptReference.ScriptMode są ignorowane.