ScriptMode Enumeração

Definição

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
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

ScriptManager No controle , Inherit é equivalente a Auto. ScriptReference No controle , o ScriptMode valor de ScriptManager determina qual versão do script do 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 ScriptManager seguir mostra uma página em que as versões de script são definidas declarativamente como Release no 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 de 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 Name propriedades e Assembly . Os resultados do valor são os ScriptMode.Auto seguintes:

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 for definida ScriptMode.Debugcomo , 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 de cliente são usadas em todo o site. Os ScriptMode valores nas ScriptManager.ScriptMode propriedades e ScriptReference.ScriptMode são ignorados.

Aplica-se a