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 os objetos ScriptManager e ScriptReference fazem referência a uma versão de depuração ou lançamento dos scripts de cliente.
public enum class ScriptMode
public enum ScriptMode
type ScriptMode =
Public Enum ScriptMode
- Herança
Campos
Auto | 0 | No controle ScriptManager, a versão dos scripts de cliente a ser usada é determinada no tempo de execução com base no elemento <compilação> do nível do aplicativo do arquivo Web.config, a menos que ele seja substituído em uma instância do controle ScriptReference. No controle ScriptReference, 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. |
Debug | 2 | No controle ScriptManager, a versão de depuração do script de cliente é usada na página da Web a menos que seja substituída em uma instância do controle ScriptReference. No controle ScriptReference, a versão de depuração do script de cliente é usada na página da Web. |
Inherit | 1 | No controle ScriptManager, Inherit é equivalente a Auto. No controle ScriptReference, o valor ScriptMode de ScriptManager determina qual versão do script de cliente usar. |
Release | 3 | No controle ScriptManager, a versão de lançamento do script de cliente é usada na página da Web a menos que seja substituída configurando a propriedade ScriptMode de uma instância ScriptReference para Debug. No controle ScriptReference, a versão de lançamento do script de 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ída 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 fazer referência ao 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.