ScriptMode Enumerazione
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Specifica se ScriptManager e ScriptReference oggetti fanno riferimento alla versione di debug o versione degli script client.
public enum class ScriptModepublic enum ScriptModetype ScriptMode = Public Enum ScriptMode- Ereditarietà
Campi
| Nome | Valore | Descrizione |
|---|---|---|
| Auto | 0 | ScriptManager Nel controllo la versione degli script client da usare viene determinata in fase di esecuzione in base all'elemento di compilazione a livello <di applicazione del file Web.config, a meno che non venga sottoposto a override> in un'istanza del ScriptReference controllo . ScriptReference Nel controllo, se applicato a un file di script autonomo, Auto equivale a Release. Se applicato a un riferimento script in un assembly, Auto equivale a Inherit. |
| Inherit | 1 | ScriptManager Nel controllo Inherit equivale a Auto. ScriptReference Nel controllo il ScriptMode valore di ScriptManager determina la versione dello script client da usare. |
| Debug | 2 | ScriptManager Nel controllo viene utilizzata la versione di debug dello script client nella pagina Web, a meno che non venga sottoposto a override in un'istanza del ScriptReference controllo . ScriptReference Nel controllo viene usata la versione di debug dello script client nella pagina Web. |
| Release | 3 | ScriptManager Nel controllo viene usata la versione di rilascio dello script client nella pagina Web, a meno che non venga sottoposto a override impostando la proprietà di un'istanza ScriptModeScriptReference su Debug. ScriptReference Nel controllo viene usata la versione di rilascio dello script client nella pagina Web. |
Esempio
Nell'esempio seguente viene illustrata una pagina in cui le versioni di 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 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]Path sono entrambi specificati, la proprietà [ScriptReference.Path]Path viene usata invece di Name, ma il ScriptMode.Auto valore è comunque equivalente a ScriptMode.Inherit.
Se la versione richiesta dello script non esiste, viene generato un errore. Ad esempio, viene generato un errore se viene eseguito 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. I riferimenti agli script in un assembly restituiscono la versione di rilascio se la versione di debug non esiste.
Annotazioni
Quando l'attributo retail dell'elemento 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.
