ScriptMode Enumeração
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Especifica se ScriptManager e ScriptReference objetos se referem à versão de depuração ou de release dos scripts do cliente.
public enum class ScriptModepublic enum ScriptModetype ScriptMode = Public Enum ScriptMode- Herança
Campos
| Name | Valor | Description |
|---|---|---|
| Auto | 0 | No ScriptManager controlo, a versão dos scripts cliente a usar é determinada em tempo de execução com base no elemento de compilação> ao nível< da aplicação do ficheiro Web.config, a menos que seja sobreposto numa instância do ScriptReference controlo. No ScriptReference controlo, quando aplicado a um ficheiro de script autónomo, Auto é equivalente a Release. Quando aplicado a uma referência de script numa montagem, Auto é equivalente a Inherit. |
| Inherit | 1 | No ScriptManager controlo, Inherit é equivalente a Auto. No ScriptReference controlo, o ScriptMode valor from ScriptManager determina qual versão do script cliente usar. |
| Debug | 2 | No ScriptManager controlo, a versão de depuração do script cliente é usada na página Web, a menos que seja sobreposta numa instância do ScriptReference controlo. No ScriptReference controlo, a versão de depuração do script cliente é usada na página Web. |
| Release | 3 | No ScriptManager controlo, a versão de release do script cliente é usada na página Web, a menos que seja sobreposta ao definir a ScriptMode propriedade de uma ScriptReference instância para Debug. No ScriptReference controlo, a versão de lançamento do script cliente é usada na página Web. |
Exemplos
O exemplo seguinte mostra uma página onde as versões do script são declarativamente definidas como Release no ScriptManager controlo, mas um script chamado CustomClient.js está declarativamente definido como Debug no Name controlo.
<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>
Observações
A ScriptMode enumeração fornece valores para definir a versão do script cliente a ser usada numa página Web. Os valores de enumeração podem ser aplicados tanto à ScriptManager.ScriptMode propriedade como à propriedade ScriptReference.ScriptMode . O ScriptManager objeto define a versão de todos os scripts na página, a menos que seja sobreposto por um ScriptReference objeto. O ScriptReference objeto define a versão para um determinado script.
O ScriptMode.Auto valor produz resultados diferentes dependendo se se refere a um ficheiro de script autónomo ou a um ficheiro de script incorporado como recurso numa assembleia. Um ficheiro de script autónomo é definido com a propriedade ScriptReference.Path . Uma referência de montagem deve ser acedida através das Name propriedades e.Assembly Os resultados para o ScriptMode.Auto valor são os seguintes:
Quando é aplicado a um ficheiro de script autónomo onde a propriedade [ScriptReference.Path]Path é especificada, o ScriptMode.Auto valor é equivalente a ScriptMode.Release.
Quando é aplicado a uma referência de script numa montagem, ScriptMode.Auto é equivalente a ScriptMode.Inherit. Quando apenas Name é especificado, é usado para referenciar o guião. Quando Name e a propriedade [ScriptReference.Path]Path são ambas especificadas, a propriedade [ScriptReference.Path]Path é usada em vez de Name, mas o ScriptMode.Auto valor continua a ser equivalente a ScriptMode.Inherit.
É lançado um erro se a versão solicitada do script não existir. Por exemplo, um erro é lançado se for feita uma referência a um ficheiro de script autónomo chamado CustomScript.js e a ScriptManager.ScriptMode propriedade estiver definida para ScriptMode.Debug, mas CustomScript.debug.js não existir no site. As referências a scripts num assembly retornam a versão de lançamento se a versão de depuração não existir.
Note
Quando o retail atributo do elemento de implementação do ficheiro de Machine.config é definido para true, as versões de lançamento dos scripts cliente são usadas em todo o site. Os ScriptMode valores nas ScriptManager.ScriptMode propriedades ScriptReference.ScriptMode são ignorados.