Partilhar via

Visão geral do JScript IntelliSense

  • Artigo

IntelliSense para o Microsoft JScript facilita a elementos de programação de script de cliente de acesso no editor de código em Visual Studio ou Microsoft Visual Web Developer Express Edition. IntelliSense oferece opções apropriado de contexto de código conforme você digita o código de script de cliente, sistema autônomo propriedades, funções e objetos.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 necessárias e inserir elementos de linguagem diretamente em seu código.IntelliSense para JScript funciona como o IntelliSense para idiomas do código gerenciado.

Este tópico contém as seções a seguir:

  • Segundo plano

  • Recursos de JScript IntelliSense

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

  • Recursos adicionais

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

Segundo plano

IntelliSense ajuda você a escrever código mais rapidamente e com menos erros, fornecendo informações enquanto você codifica.Ao trabalhar com script de cliente, IntelliSense lista sistema autônomo objetos, funções, propriedades e parâmetros disponível com base em seu contexto corrente.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 a IntelliSense personalizado com comentários de código XML.

Como funciona o JScript IntelliSense

JScript IntelliSense fornece opções de codificação com base em todos os script que é relevante para seu contexto de programação corrente.Isso inclui elementos no arquivo corrente de script.Ele também inclui qualquer código que é referenciado direta ou indiretamente no seu script, sistema autônomo referências de arquivo de script, referências de script do assembly, referências de serviço e sistema autônomo referências associadas a página.

Determinar o contexto do IntelliSense

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

  • Funções definidas no bloco de script corrente.Há suporte para os blocos de script embutido em arquivos que têm as extensões de nome de arquivo .aspx., .ascx,. mestre, .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 a extensão de nome de arquivo .js.

  • Arquivos JScript que referenciar outros arquivos JScript, usando o references diretiva.

  • Referências a Serviços Web XML.

  • The ScriptManager e ScriptManagerProxy controles, se aplicativo Web Web for um aplicativo Web ASP.NET AJAX.

  • The Microsoft AJAX Library, se você estiver trabalhando em um aplicativo Web habilitado para AJAX ASP.NET.

    Observação:

    Não há suporte para IntelliSense Para script que está no Evento - manipulador de atributos em elementos HTML , ou Isso é definido em href atributos.

Processando informações do IntelliSense

Forneça o JScript IntelliSense, Visual Studio executa as seguintes operações:

  • Cria uma lista de arquivo JScript dependente que está baseado em referências no documento ativo e baseado em recursivamente examinando as referências de script em arquivos referenciados.

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

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

  • Monitora sistema autônomo arquivos para sistema autônomo alterações que podem afetar a lista do IntelliSense e atualiza a lista conforme necessário.

Voltar ao topo

Recursos de JScript IntelliSense

JScript IntelliSense suporta os seguintes objetos:

  • Elementos do documento DOM (modelo de objeto)

  • Objetos intrínsecos

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

  • Referências de arquivo externo

  • Comentários de código XML

  • Objetos do ASP.NET AJAX

Elementos DOM HTML

JScript IntelliSense fornece referências de programação para elementos DOM DHTML (Dynamic HTML), sistema autônomo body, form, e div. Apenas os elementos que são incluídos na página de documento e o mestre corrente são exibidos por IntelliSense.JScript IntelliSense também oferece suporte a window e document os objetos e seus membros.

Objetos intrínsecos

JScript IntelliSense fornece programação referências a 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 JScript, Visual Studio varreduras aberto e referenciado documentos para determinar todos os recursos de código disponível. Isso inclui as variáveis, funções e objetos que você criou.Esses recursos, em seguida, estão disponível para o JScript IntelliSense.

Para obter mais informações sobre as variáveis definidas pelo usuário, funções e objetos, consulte Criando 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 permite que o script de cliente para ser armazenada em cache pelo navegador.

Se você estiver trabalhando com um ASP.NET AJAX - ativado página da Web, você pode referenciar arquivos de script, usando o ScriptReference objeto da ScriptManager controle.

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

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

Se você não estiver trabalhando com uma página da Web ASP.NET habilitado por AJAX, você pode referenciar um arquivo de script externo, usando o src atributo na marca de abertura de um script elemento. The 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 usa o srco 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 sistema autônomo recursos em um assembly em aplicativos Web do ASP.NET AJAX.Para obter mais informações sobre recursos de script incorporado, consulte Demonstra Passo a passo: Incorporar um arquivo JavaScript como um recurso em um assembly.

Diretivas de referências

A references diretiva ativa Visual Studio para estabelecer uma relação entre o script que você está editando e outros scripts. The references diretiva permite que você incluir um arquivo de script no contexto de script do arquivo de script corrente. Isso permite que o IntelliSense fazer referência a campos, tipos e funções definidas externamente sistema autônomo você codifica.

Criar um references diretiva na forma de um comentário XML. A diretiva deve ser declarada anteriormente no arquivo que qualquer script.A reference diretiva pode incluir uma referência de script baseadas em disco, uma referência de script com base 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 com base em assembly.

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

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

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

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

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

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

Observação:

JScript IntelliSense não há suporte para script Isso é contido em Serviço da Web (.asmx ) arquivos Em () Na Web aplicativo Web Projects WAP ).

O exemplo a seguir mostra como fazer referência a script com base 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.

  • The reference 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 padrão de comentários (duas barras) são ignoradas.

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

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

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

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

  • Caminhos absolutos são ignorados.

  • Referências para arquivos fora do projeto corrente serão ignoradas.

  • As 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 resolvido recursivamente para páginas.Somente script referenciado 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 o IntelliSense ao fazer referência a script comentado.Comentários de código XML estão disponível somente em arquivos referenciados, assemblies e serviços.

Você pode incluir comentários de código XML para fornecer um resumo e fornecer informações sobre valor retornado da função e parâmetros.O exemplo a seguir mostra um script que utiliza comentários do 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 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 arquivo .aspx.

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

Objetos do ASP.NET AJAX

O ASP.NET AJAX também oferece suporte a JScript IntelliSense.ASP.NET AJAX inclui uma estrutura de cliente que se estende os tipos padrão que estão disponível no ECMAScript (JavaScript e JScript).Para ativar o JScript IntelliSense fornecer detalhes sobre objetos do ASP.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 biblioteca do ASP.NET AJAX.

Observação:

Private membros não são exibidas por JScript IntelliSense.Membros particulares são indicados sistema autônomo membros que começam com um sublinhado no ASP.NET AJAX (_) .

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

O mecanismo JScript IntelliSense no Visual Studio fornece automaticamente a validação, verificando referência links e pre-processador execução do script. Validação de link de referência de script é determinada com base no contexto de programação corrente.Se uma referência específica não for encontrado, Visual Studio Fornece informações de erro sobre a referência. Pre-processador erro relatar ocorre quando a execução de dependentes de arquivos falhar.

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

Chamar validação JScript

In Visual StudioValidação do JScript IntelliSense é chamada de duas maneiras:

  • Quando ocioso.Validação é invocada quando automaticamente ocioso em qualquer documento ativo que contém script.

  • Manualmente.Manualmente, você pode chamar validação JScript IntelliSense.Para fazer isso, sobre o edição menu, clicar Avançadoe, em seguida, clicar Validar documento.Este 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 impedir que o mecanismo IntelliSense obtenham resultados completos do contexto do script corrente Visual Studio Fornece comentários das seguintes maneiras:

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

  • erro Lista janela.The Lista de erros 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 Lista de erros janela, no Modo de exibição menu, clicar Lista de erros.

Voltar ao topo

Recursos adicionais

Demonstra Passo a passo: JScript IntelliSense

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

Voltar ao topo

Consulte também

Tarefas

Demonstra Passo a passo: JScript IntelliSense

Atribuindo Referências a Scripts Dinamicamente

Referência

Listar Membros

Outros recursos

Usando o IntelliSense

Sobre o modelo de objeto DHTML

Objetos de JScript