ScriptMode Enumerazione

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Specifica se gli oggetti ScriptManager e ScriptReference fanno riferimento alla versione di debug o rilascio degli script client.

public enum class ScriptMode

public enum ScriptMode

type ScriptMode = 

Public Enum ScriptMode

Ereditarietà

Object

ValueType

Enum

ScriptMode

Campi

Auto	0	Nel controllo ScriptManager, la versione degli script client da usare è determinata in fase di esecuzione in base all'elemento <compilation> a livello di applicazione del file Web.config, a meno che non ne sia stato eseguito l'override in un'istanza di controlloScriptReference. Nel controllo ScriptReference, se applicato a un file di script autonomo, Auto equivale a Release. Se applicato a un riferimento di script in un assembly, Auto equivale a Inherit.
Debug	2	Nel controllo ScriptManager, nella pagina Web viene usata la versione di debug dello script client, a meno che non ne sia stato eseguito l'override in un'istanza del controllo ScriptReference. Nel controllo ScriptReference, nella pagina Web viene usata la versione di debug dello script client.
Inherit	1	Nel controllo ScriptManager, Inherit equivale a Auto. Nel controllo ScriptReference, il valore ScriptMode ricavato da ScriptManager determina la versione dello script client da usare.
Release	3	Nel controllo ScriptManager, nella pagina Web viene usata la versione di rilascio dello script client, a meno che non ne sia stato eseguito l'override impostando la proprietà ScriptMode di un'istanza di ScriptReference su Debug. Nel controllo ScriptReference, nella pagina Web viene usata la versione di rilascio dello script client.

Esempio

Nell'esempio seguente viene illustrata una pagina in cui le versioni dello script sono impostate in modo dichiarativo su Release nel ScriptManager controllo, ma uno script denominato CustomClient.js è impostato in modo dichiarativo su Debug nel Name controllo.

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

Commenti

L'enumerazione ScriptMode fornisce valori per impostare la versione dello script client da usare in una pagina Web. I valori di enumerazione possono essere applicati alla ScriptManager.ScriptMode proprietà o alla proprietà ScriptReference.ScriptMode . L'oggetto ScriptManager imposta la versione per tutti gli script nella pagina, a meno che non venga sottoposto a override da un ScriptReference oggetto. L'oggetto ScriptReference imposta la versione per uno script specifico.

Il ScriptMode.Auto valore produce risultati diversi a seconda che faccia riferimento a un file di script autonomo o a un file di script incorporato come risorsa in un assembly. Un file di script autonomo viene definito con la proprietà ScriptReference.Path . È necessario accedere a un riferimento all'assembly tramite le Name proprietà e Assembly . I risultati per il ScriptMode.Auto valore sono i seguenti:

• Quando viene applicato a un file di script autonomo in cui viene specificata la proprietà [ScriptReference.Path]Path , il ScriptMode.Auto valore equivale a ScriptMode.Release.

• Quando viene applicato a un riferimento allo script in un assembly, ScriptMode.Auto equivale a ScriptMode.Inherit. Quando viene specificato solo Name , viene usato per fare riferimento allo script. Quando Name e la proprietà [ScriptReference.Path] sono entrambe specificate, la proprietà [ScriptReference.Path]PathPath viene usata anziché Name, ma il ScriptMode.Auto valore è ancora equivalente a ScriptMode.Inherit.

Viene generato un errore se la versione richiesta dello script non esiste. Ad esempio, viene generato un errore se viene effettuato un riferimento a un file di script autonomo denominato CustomScript.js e la ScriptManager.ScriptMode proprietà è impostata su ScriptMode.Debug, ma CustomScript.debug.js non esiste nel sito. Riferimenti agli script in un assembly restituiscono la versione di versione se la versione di debug non esiste.

Nota

Quando l'attributo dell'elemento retail di distribuzione del file Machine.config è impostato su true, le versioni di rilascio degli script client vengono usate in tutto il sito Web. I ScriptMode valori nelle ScriptManager.ScriptMode proprietà e ScriptReference.ScriptMode vengono ignorati .