Compartilhar via


Instruções de compilação condicional

As instruções a seguir permitem JScript controlar a compilação de um script, dependendo dos valores das variáveis de compilação condicional. Você pode usar as variáveis fornecidas por JScript ou você pode definir seu próprio com o @set diretiva ou o /define opção de linha de comando.

Instruções

Instrução

Descrição

@ cc_on

Ativa o suporte de compilação condicional.

@ if

Executa condicionalmente um grupo de declarações, dependendo do valor de uma expressão.

@ set

Cria variáveis usadas com instruções de compilação condicional.

O @cc\_on, @if, ou @set instruções ativar compilação condicional. Alguns usos típicos para compilação condicional incluem usando os novos recursos JScript, incorporando o suporte à depuração em um script e execução de código de rastreamento.

Ao escrever os scripts sejam executados por navegadores da Web, sempre coloque o código de compilação condicional nos comentários. Conseqüentemente, os hosts que não oferecem suporte a compilação condicional podem ignorá-la. Aqui está um exemplo.

/*@cc_on @*/
/*@if (@_jscript_version >= 5)
document.write("JScript Version 5.0 or better.<BR>");
@else @*/
document.write("You need a more recent script engine.<BR>");
/*@end @*/

Este exemplo usa os delimitadores de comentários especiais que são usados somente se o @cc\_on tiver ativado a instrução de compilação condicional. Os mecanismos de script não oferecem suporte a compilação condicional exibem uma mensagem avisando sobre a necessidade de um novo mecanismo de script sem gerar erros. Os mecanismos que oferecem suporte a compilação condicional compilar o primeiro ou segundo document.write, dependendo da versão do mecanismo. Observe que a versão 7.x representa o JScript.NET. Para obter mais informações, consulte Detecção de capacidades do navegador.

Compilação condicional também é útil para scripts do lado do servidor e programas de linha de comando. Nesses aplicativos, a compilação condicional pode ser usada para compilar a funções adicionais em um programa para ajudar na criação de perfil quando estiver no modo de depuração.

Consulte também

Referência

/Define

Conceitos

Variáveis de compilação condicional

Diretivas de compilação condicional

Detecção de capacidades do navegador

Outros recursos

Compilação condicional