ScriptMode Wyliczenie

Definicja

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
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 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:

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.

Dotyczy