ScriptMode Enumeração

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.Extensions.dll

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

Object

ValueType

Enum

ScriptMode

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.