ScriptMode Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica se ScriptManager e ScriptReference objetos se referem à versão de depuração ou versão de versão dos scripts do cliente.
public enum class ScriptModepublic enum ScriptModetype ScriptMode = Public Enum ScriptMode- Herança
Campos
| Nome | Valor | Description |
|---|---|---|
| Auto | 0 | ScriptManager No controle, a versão dos scripts do cliente a ser usada é determinada em tempo de execução com base no elemento de compilação> no nível< do aplicativo do arquivo Web.config, a menos que ele seja substituído em uma instância do ScriptReference controle. ScriptReference No controle, quando aplicado a um arquivo de script autônomo, Auto é equivalente a Release. Quando aplicado a uma referência de script em um assembly, Auto é equivalente a Inherit. |
| Inherit | 1 | ScriptManager No controle, Inherit é equivalente a Auto. ScriptReference No controle, o ScriptMode valor de ScriptManager determina qual versão do script do cliente usar. |
| Debug | 2 | ScriptManager No controle, a versão de depuração do script do cliente é usada na página da Web, a menos que seja substituída em uma instância do ScriptReference controle. ScriptReference No controle, a versão de depuração do script do cliente é usada na página da Web. |
| Release | 3 | ScriptManager No controle, a versão de versão do script do cliente é usada na página da Web, a menos que seja substituída definindo a ScriptMode propriedade de uma ScriptReference instância como Debug. ScriptReference No controle, a versão de versão do script do cliente é usada na página da Web. |
Exemplos
O exemplo a seguir mostra uma página em que as versões de script são definidas declarativamente como Versão no ScriptManager controle, mas um script chamado CustomClient.js é definido declarativamente como Depurar no Name controle.
<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>
Comentários
A ScriptMode enumeração fornece valores para definir a versão do script do cliente a ser usada em uma página da Web. Os valores de enumeração podem ser aplicados à ScriptManager.ScriptMode propriedade ou à propriedade ScriptReference.ScriptMode . O ScriptManager objeto define a versão para todos os scripts na página, a menos que seja substituído por um ScriptReference objeto. O ScriptReference objeto define a versão de um script específico.
O ScriptMode.Auto valor produz resultados diferentes dependendo se ele se refere a um arquivo de script autônomo ou a um arquivo de script inserido como um recurso em um assembly. Um arquivo de script autônomo é definido com a propriedade ScriptReference.Path . Uma referência de assembly deve ser acessada por meio das propriedades e do Name assembly Assembly . Os resultados do valor são os ScriptMode.Auto seguintes:
Quando ele é aplicado a um arquivo de script autônomo em que a propriedade [ScriptReference.Path]Path é especificada, o ScriptMode.Auto valor é equivalente a ScriptMode.Release.
Quando ele é aplicado a uma referência de script em um assembly, ScriptMode.Auto é equivalente a ScriptMode.Inherit. Quando é especificado apenas Name , ele é usado para referenciar o script. Quando Name e a propriedade [ScriptReference.Path]Path são especificadas, a propriedade [ScriptReference.Path]Path é usada em vez de Name, mas o ScriptMode.Auto valor ainda é equivalente a ScriptMode.Inherit.
Um erro será gerado se a versão solicitada do script não existir. Por exemplo, um erro será gerado se uma referência for feita a um arquivo de script autônomo chamado CustomScript.js e a ScriptManager.ScriptMode propriedade estiver definida como ScriptMode.Debug, mas CustomScript.debug.js não existir no site. Referências a scripts em um assembly retornam a versão de versão se a versão de depuração não existir.
Observação
Quando o retail atributo do elemento de implantação do arquivo Machine.config é definido como true, as versões de versão dos scripts do cliente são usadas em todo o site. Os ScriptMode valores nas ScriptManager.ScriptMode propriedades ScriptReference.ScriptMode são ignorados.
