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 ScriptModepublic enum ScriptModetype 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 | 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:
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 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.
