Compartilhar via

Visão geral de IntelliSense de JScript

  • Artigo

IntelliSense para JScript do Microsoft facilita a elementos de programação de script de cliente de acesso no código do editor do Visual Studio ou Microsoft Visual Web Developer Express. IntelliSense oferece opções de código apropriado do contexto, conforme você digita o código de script de cliente, como, por exemplo, objetos, funções e propriedades. Não é necessário deixar o código do editor para procurar a documentação de sintaxe ou parâmetro. Em vez disso, você pode permanecer no editor de código, encontrar as informações que você precisa e insere elementos de linguagem diretamente em seu código. IntelliSense de JScript funciona como IntelliSense para idiomas do código gerenciado.

This topic contains the following sections:

  • Background

  • Recursos de IntelliSense de JScript

  • Noções básicas sobre os erros de IntelliSense de JScript

  • Additional Resources

Para obter mais informações sobre a funcionalidade de IntelliSense de Visual Studio, consulte Usando o IntelliSense.

Background

IntelliSense ajuda você a escrever código mais rápido e com menos erros, fornecendo informações enquanto você codifica. Enquanto você trabalha com script de cliente, IntelliSense lista de objetos, funções, propriedades e parâmetros que estão disponíveis com base em seu contexto atual. Você pode selecionar uma opção de codificação na lista pop-up fornecida pelo IntelliSense para concluir o código.

IntelliSense facilita a concluir as seguintes tarefas:

  • Para obter informações do membro.

  • Inserir elementos de linguagem diretamente em seu código.

  • Manter seu contexto sem ter de deixar o código do editor.

  • Suporte personalizado IntelliSense com os comentários de código XML.

Como funciona o IntelliSense de JScript

JScript IntelliSense fornece opções de codificação com base em todos os scripts relevantes ao seu contexto atual de programação. Isso inclui scripts de elementos no arquivo atual. Ele também inclui qualquer código que mencionados direta ou indiretamente de seu script, como, por exemplo, referências de arquivo de script, referências de script do assembly, referências de serviço e referências de página associada.

Determinação do contexto de IntelliSense

Seu contexto de programação atual é criado com base nos seguintes itens:

  • As funções que são definidas no bloco de script atual. Blocos de script embutido são compatíveis com os arquivos que têm as extensões de nome de arquivo. aspx.,. ascx,. master,. HTML e. htm.

  • Cada script o elemento que contém um src atributo que aponta para um arquivo de script. O arquivo de script de destino deve ter o. js a extensão de nome de arquivo.

  • Os arquivos de JScript que fazem referência a outros arquivos de JScript usando o references diretiva.

  • Referências a XML Web services.

  • O ScriptManager e ScriptManagerProxy controles, se o aplicativo da Web é um aplicativo ASP.NET AJAX application.

  • O Microsoft Ajax Library, se você estiver trabalhando em um aplicativo habilitado para AJAX do ASP.NET Web application.

    ObservaçãoObservação

    IntelliSense não há suporte para o script que está nos atributos do manipulador de eventos em elementos HTML ou que está definido na href atributos.

Processando informações de IntelliSense

Para fornecer JScript IntelliSense, Visual Studio realiza as seguintes operações:

  • Cria uma lista de arquivo dependente de JScript que são baseados em referências no documento ativo e com base em recursivamente examinando as referências de script nos arquivos referenciados.

  • Percorre a lista e a coleta de informações de tipo e outros dados relevantes de cada arquivo.

  • Agrega os dados e passa para o mecanismo de JScript, que disponibiliza as informações de tipo e os dados para IntelliSense.

  • Monitora os arquivos para as alterações que podem afetar a lista de IntelliSense e atualiza a lista, conforme necessário.

Back to top

Recursos de IntelliSense de JScript

JScript IntelliSense suporta os seguintes objetos:

  • Documentar os elementos Object Model (DOM)

  • Objetos intrínsecos

  • Objetos, funções e variáveis definidas pelo usuário

  • Referências de arquivo externo

  • Comentários de código XML

  • ASP.Objetos de NET AJAX

Elementos de DOM HTML

JScript IntelliSense fornece referências de programação para elementos de DOM de HTML dinâmico (DHTML), como body, form, e div. Apenas os elementos que estão incluídos na página atual do documento e o mestre são exibidos por IntelliSense. IntelliSense de JScript também oferece suporte a window e document objetos e seus membros.

Objetos intrínsecos

JScript IntelliSense fornece referências de programação para os objetos intrínsecos nativamente Array, String, Math, Date, e Number. Para obter mais informações sobre objetos intrínsecos, consulte Objetos intrínsecos.

Variáveis, funções e objetos definidos pelo usuário

Quando você altera um arquivo de JScript, Visual Studio varreduras aberto e referenciado documentos para determinar todos os recursos de código disponíveis. Isso inclui as variáveis, funções e objetos que você criou. Esses recursos, em seguida, estão disponíveis para o IntelliSense de JScript.

Para obter mais informações sobre objetos, funções e variáveis definidas pelo usuário, consulte Criar seus próprios objetos no site do MSDN.

Referências de arquivo externo

Em vez de escrever todos os scripts de cliente em uma página, você pode fazer referência a arquivos externos que incluem o código de script. Isso facilita a reutilização de código entre as páginas e possibilita que o script de cliente para ser armazenada em cache pelo navegador.

Se você estiver trabalhando com um aplicativo ASP.Habilitado para AJAX NET da Web, você pode fazer referência a arquivos de script usando o ScriptReference o objeto da ScriptManager de controle.

O exemplo a seguir mostra a marcação que usa um ScriptReference de objeto em um ScriptManager o controle para fazer referência a um arquivo de script.

<asp:ScriptManager ID="ScriptManager1" runat="server">
  <Scripts>
    <asp:ScriptReference Path="~/Scripts/JScript.js" />
  </Scripts>
</asp:ScriptManager>

Se você não estiver trabalhando com um aplicativo ASP.Habilitado para AJAX NET da Web, você pode referenciar um arquivo de script externo, usando o src atributo na marca de abertura de um script elemento. O src atributo especifica a URL para um arquivo externo que contém o código-fonte ou dados.

O exemplo a seguir mostra a marcação que usa o src o atributo em um <script> marca para fazer referência a um arquivo de script.

<script type="text/javascript" src="~/Scripts/JScript.js">
  
</script>

IntelliSense também oferece suporte a arquivos de script incorporados como recursos em um assembly no ASP.NET AJAX Web distribuídos. Para obter mais informações sobre os recursos de script incorporado, consulte Passo a passo: incorporando um arquivo JavaScript como um Recurso em um conjunto de módulos (Assembly).

Diretivas de referências

A references diretiva permite que Visual Studio para estabelecer uma relação entre o script que você está editando e outros scripts. O references diretiva permite que você incluir um arquivo de script no contexto de script do arquivo atual do script. Isso permite que o IntelliSense fazer referência a campos, tipos e funções definidas externamente como você o código.

Você cria um references diretiva na forma de um comentário XML. A diretiva deve ser declarada anteriormente no arquivo de qualquer script. A reference diretiva pode incluir uma referência de script baseadas em disco, uma referência de script baseadas em assembly, uma referência de script baseada em serviços ou uma referência de script baseado em página.

O exemplo a seguir mostra exemplos de uso de diretivas de referência baseadas em disco.

/// <reference path="ScriptFile1.js" />

/// <reference path="Scripts/ScriptFile2.js" />

/// <reference path="../ScriptFile3.js" />

/// <reference path="~/Scripts/ScriptFile4.js" />

O exemplo a seguir mostra como criar uma referência a um script baseado em assembly.

/// <reference name "Ajax.js" assembly="System.Web.Extensions, ..." />

O exemplo a seguir mostra como fazer referência a scripts baseados em serviço:

/// <reference path="MyService.asmx" />

/// <reference path="Services/MyService.asmx" />

/// <reference path="../MyService.asmx" />

/// <reference path="~/Services/MyService.asmx" />

ObservaçãoObservação

JScript IntelliSense não há suporte para o script que está contido nos arquivos do Web service (. asmx) em projetos de aplicativo da Web (WAP).

O exemplo a seguir mostra como fazer referência a script baseado em página.

/// <reference path="Default.aspx" />

/// <reference path="Admin/Default.aspx" />

/// <reference path="../Default.aspx" />

/// <reference path="~/Admin/Default.aspx" />

As seguintes regras se aplicam a uma reference diretiva.

  • O reference o comentário XML deve ser declarado antes de qualquer script.

  • Você deve usar a sintaxe de comentários XML com três barras. As referências feitas usando a sintaxe do padrão de comentários (duas barras) são ignoradas.

  • Apenas um arquivo ou recurso pode ser especificado por diretiva.

  • Várias referências ao scripts com base em página não são permitidas.

  • Se uma referência de página for especificada, nenhum outro tipo de diretivas de referência é permitido.

  • Os nomes de arquivo usam caminhos relativos. Você pode usar o operador til (~) para tornar relativo à raiz do aplicativo caminhos.

  • Caminhos absolutos são ignorados.

  • As referências a arquivos fora do projeto atual são ignoradas.

  • Diretivas de referência em páginas de referência não serão processadas — isto é, as diretivas de referência não são resolvida recursivamente para páginas. Somente o script que faz referência diretamente a página está incluído.

Comentários de código XML

Comentários de código XML são as descrições de texto que você adicionar ao script. Essas descrições de texto são exibidas com IntelliSense quando você faz referência o script comentado. Comentários de código XML estão disponíveis somente a partir de serviços, assemblies e arquivos referenciados.

Você pode incluir comentários de código XML para fornecer um resumo e para fornecer informações sobre os parâmetros e o valor de retorno da função. O exemplo a seguir mostra um script que usa comentários de código XML:

function areaFunction(radiusParam)
{
    /// <summary>Determines the area of a cicle based on a radius parameter.</summary>
    /// <param name="radius" type="Number">The radius of the circle.</param>
    /// <returns type="Number">Returns a number that represents the area.</returns>
    var areaVal;
    areaVal = Math.PI * radiusParam * radiusParam;
    return areaVal;
}

IntelliSense pode exibir referências de código para comentários XML nos seguintes cenários de referência de arquivo:

  • Um arquivo. aspx que faz referência a um arquivo. js.

  • Um arquivo. js que faz referência a outro do arquivo. js.

  • Um arquivo. js que faz referência a um arquivo. aspx.

IntelliSense não está disponível quando um arquivo. aspx faz referência a outro do arquivo. aspx.

Para obter mais informações sobre como adicionar comentários de código XML para fornecer IntelliSense de JScript, consulte Demonstra Passo a passo: IntelliSense de JScript.

ASP.NET objetos de AJAX

ASP.NET AJAX também oferece suporte a IntelliSense de JScript. ASP.NET AJAX inclui uma estrutura de cliente que se estende os tipos padrão que estão disponíveis no ECMAScript (JavaScript e JScript). Para habilitar o IntelliSense de JScript fornecer detalhes sobre o ASP.Objetos de NET AJAX, comentários de código XML foram adicionados em todo o Microsoft Ajax Library. Esses comentários de código XML são exibidos quando você usa tipos e membros que estão contidos na página ASP.NET AJAX Library.

ObservaçãoObservação

Membros particulares não são exibidos por JScript IntelliSense. Membros particulares são indicados no ASP.NET AJAX, como os membros que começam com um sublinhado (_).

Noções básicas sobre os erros de IntelliSense de JScript

O mecanismo de IntelliSense de JScript no Visual Studio fornece automaticamente a validação, verificando os links de referência de script e execução de pre-processor. Validação de link de referência de script é determinada com base no contexto atual de programação. Se uma determinada referência não for encontrada, Visual Studio fornece informações de erro sobre a referência. Emissão de relatórios de erro Pre-Processor ocorre quando a execução de dependentes de arquivos falhar.

Para obter mais informações sobre como o link de validação é determinada, consulte Determinar o contexto de IntelliSense. Para obter mais informações sobre como os erros de pre-processor são determinados, consulte Processamento de informações de IntelliSense.

Invocar a validação do Jscript

Em Visual Studio, IntelliSense de JScript validação é chamada de duas maneiras:

  • Quando ocioso. Validação é chamada de ociosidade automaticamente em qualquer documento ativo que contém o script.

  • Manualmente. Também manualmente, você pode chamar validação de IntelliSense de JScript. Para fazer isso, no Editar menu, clique em Advancede em seguida, clique em Validar o documento. Esse comando se aplica a todos os documentos abertos.

Resultados de validação

Quando Visual Studio não é possível resolver as referências de script, ou se outros tipos de erros de script impedem que o mecanismo de IntelliSense obtenham resultados completos do script atual contexto, Visual Studio fornece comentários das seguintes maneiras:

  • Elementos sublinhados no editor. Linhas vermelhas onduladas indicam erros. Se você mantiver o ponteiro do mouse sobre o erro, uma dica de ferramenta exibe a descrição do erro.

  • Lista de erros janela. O Error List janela exibe a descrição do erro, o arquivo onde ocorreu o erro, o número de linha e coluna e o projeto. Para exibir o Error List janela, na Exibir menu, clique em Error List.

Back to top

Additional Resources

Demonstra Passo a passo: IntelliSense de JScript

Como: Criar comentários de código XML de JScript

Back to top

Consulte também

Tarefas

Demonstra Passo a passo: IntelliSense de JScript

Atribuindo Referências a Scripts Dinamicamente

Referência

Listar Membros

Outros recursos

Usando o IntelliSense

Sobre o modelo de objeto DHTML

Objetos de JScript

atributo SRC | Propriedade src