ScriptMode Enumerazione

Definizione

Specifica se gli oggetti ScriptManager e ScriptReference fanno riferimento alla versione di debug o rilascio degli script client.Specifies whether ScriptManager and ScriptReference objects refer to the debug or release version of client scripts.

public enum class ScriptMode
public enum ScriptMode
type ScriptMode = 
Public Enum ScriptMode
Ereditarietà
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.In the ScriptManager control, the version of client scripts to use is determined at run time based on the application-level <compilation> element of the Web.config file, unless it is overridden in an instance of the ScriptReference control. Nel controllo ScriptReference, se applicato a un file di script autonomo, Auto equivale a Release.In the ScriptReference control, when applied to a standalone script file, Auto is equivalent to Release. Se applicato a un riferimento di script in un assembly, Auto equivale a Inherit.When applied to a script reference in an assembly, Auto is equivalent to 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.In the ScriptManager control, the debug version of the client script is used on the Web page unless overridden in an instance of the ScriptReference control. Nel controllo ScriptReference, nella pagina Web viene usata la versione di debug dello script client.In the ScriptReference control, the debug version of the client script is used on the Web page.

Inherit 1

Nel controllo ScriptManager, Inherit equivale a Auto.In the ScriptManager control, Inherit is equivalent to Auto. Nel controllo ScriptReference, il valore ScriptMode ricavato da ScriptManager determina la versione dello script client da usare.In the ScriptReference control, the ScriptMode value from ScriptManager determines which version of the client script to use.

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.In the ScriptManager control, the release version of the client script is used on the Web page unless overridden by setting the ScriptMode property of a ScriptReference instance to Debug. Nel controllo ScriptReference, nella pagina Web viene usata la versione di rilascio dello script client.In the ScriptReference control, the release version of the client script is used on the Web page.

Esempio

Nell'esempio seguente viene illustrata una pagina in cui le versioni dello script sono impostate in modo dichiarativo su Release nel controllo ScriptManager, ma uno script denominato CustomClient. js è impostato in modo dichiarativo su debug nel controllo Name.The following example shows a page where the script versions are declaratively set to Release in the ScriptManager control, but one script named CustomClient.js is declaratively set to Debug in the Name control.

<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 i valori per impostare la versione dello script client da utilizzare in una pagina Web.The ScriptMode enumeration provides values for setting the version of client script to use on a Web page. È possibile applicare i valori di enumerazione alla proprietà ScriptManager.ScriptMode o alla proprietà ScriptReference. ScriptMode .The enumeration values can be applied to either the ScriptManager.ScriptMode property or to the ScriptReference.ScriptMode property. L'oggetto ScriptManager imposta la versione per tutti gli script nella pagina a meno che non venga sottoposto a override da un oggetto ScriptReference.The ScriptManager object sets the version for all scripts on the page unless it is overridden by a ScriptReference object. L'oggetto ScriptReference imposta la versione per uno script specifico.The ScriptReference object sets the version for a particular script.

Il valore ScriptMode.Auto produce risultati diversi a seconda che si riferisca a un file di script autonomo o a un file script incorporato come risorsa in un assembly.The ScriptMode.Auto value produces different results depending on whether it refers to a standalone script file or to a script file that is embedded as a resource in an assembly. Un file di script autonomo viene definito con la proprietà ScriptReference. Path .A standalone script file is defined with the ScriptReference.Path property. È necessario accedere a un riferimento all'assembly tramite le proprietà Name e Assembly.An assembly reference must be accessed through the Name and Assembly properties. I risultati per il valore ScriptMode.Auto sono i seguenti:The results for the ScriptMode.Auto value are as follows:

Se la versione richiesta dello script non esiste, viene generato un errore.An error is thrown if the requested version of the script does not exist. Ad esempio, viene generato un errore se viene creato un riferimento a un file script autonomo denominato CustomScript. js e la proprietà ScriptManager.ScriptMode è impostata su ScriptMode.Debug, ma CustomScript. debug. js non esiste nel sito.For instance, an error is thrown if a reference is made to a standalone script file that is named CustomScript.js and the ScriptManager.ScriptMode property is set to ScriptMode.Debug, but CustomScript.debug.js does not exist on the site. I riferimenti agli script in un assembly restituiscono la versione di rilascio se la versione di debug non esiste.References to scripts in an assembly return the release version if the debug version does not exist.

Nota

Quando l'attributo retail dell'elemento Deployment del file Machine. config è impostato su true, le versioni di rilascio degli script client vengono utilizzate in tutto il sito Web.When the retail attribute of the deployment element of the Machine.config file is set to true, the release versions of client scripts are used throughout the Web site. I valori ScriptMode nelle proprietà ScriptManager.ScriptMode e ScriptReference. ScriptMode vengono ignorati.The ScriptMode values in the ScriptManager.ScriptMode and ScriptReference.ScriptMode properties are ignored.

Si applica a