ScriptMode Wyliczenie

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.Extensions.dll

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

Object

ValueType

Enum

ScriptMode

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 pliku autonomicznego skryptu, Auto jest odpowiednikiem Release. Zastosowanie 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 na stronie sieci Web jest używana wersja debugowania skryptu klienta.
Inherit	1	W kontrolce ScriptManagerInherit element 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ą deklaratywnie ustawione na Wartość Zwolnij w kontrolce ScriptManager , ale jeden skrypt o nazwie CustomClient.js jest deklaratywnie ustawiony na Debugowanie 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 właściwości ScriptReference.ScriptMode . Obiekt ScriptManager ustawia wersję dla wszystkich skryptów na stronie, chyba że jest zastępowany 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 pliku skryptu autonomicznego, 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, ScriptMode.Auto w którym określono właściwość [ScriptReference.Path],Path wartość jest równoważna ScriptMode.Release.

• Zastosowanie go do odwołania do skryptu w zestawie ScriptMode.Auto jest równoważne .ScriptMode.Inherit Po określeniu parametru Name jest on używany do odwoływanie 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 i 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

retail Gdy atrybut elementu wdrożenia pliku Machine.config jest ustawiony na truewartość , wersje skryptów klienta są używane w całej witrynie sieci Web. ScriptMode Wartości we właściwościach ScriptManager.ScriptModeScriptReference.ScriptMode są ignorowane.