Partilhar via


Encontre referências no seu código

Você pode usar o comando Localizar todas as referências para determinar onde determinados elementos de código são referenciados em toda a base de código. No editor de códigos, o comando Localizar todas as referências está disponível no menu de contexto (clique com o botão direito do mouse) do elemento ao qual você deseja encontrar referências. Você também pode selecionar o elemento e, em seguida, selecionar Shift+F12.

Os resultados aparecem em uma janela de ferramenta chamada <referências de elemento>, onde element é o nome do item que você está procurando. Uma barra de ferramentas na janela de referências permite:

  • Utilize uma lista suspensa para alterar o escopo da pesquisa. Pode optar por pesquisar apenas em documentos abertos ou alterados. Você pode aumentar ou diminuir o escopo da pesquisa, abrangendo toda a solução.
  • Copie os itens referenciados selecionados selecionando o botão Copiar . Todos os valores em todas as colunas de todas as linhas selecionadas são copiados para a área de transferência e são precedidos pelos cabeçalhos das colunas. Este formato pode ser facilmente colado numa folha de cálculo.
  • Selecione botões para ir para o local seguinte ou anterior na lista, ou selecione as teclas F8 e Shift + F8 para fazer isso.
  • Remova todos os filtros nos resultados retornados selecionando o botão Limpar todos os filtros .
  • Altere a forma como os itens devolvidos são agrupados, selecionando uma configuração no menu pendente Agrupar por.
  • Mantenha a janela de resultados de pesquisa atual selecionando o botão Manter resultados . Quando você seleciona esse botão, os resultados da pesquisa atual permanecem na janela. Novos resultados da pesquisa aparecem em uma nova janela de ferramenta.
  • Use o Modo de Exibição de Lista para alternar entre um modo de exibição de árvore e uma lista de texto sem formatação. Algumas funcionalidades estão desativadas na lista de texto sem formatação.
  • Pesquise cadeias de caracteres nos resultados da pesquisa inserindo texto na caixa Pesquisar Localizar Todas as Referências .

Você também pode passar o ponteiro do mouse sobre qualquer resultado de pesquisa para ver a referência no contexto do código ao redor:

Captura de ecrã da janela Localizar Todas as Referências.

Você pode usar os seguintes métodos para navegar até referências na janela de referências:

  • Selecione uma referência e, em seguida, selecione a tecla Enter ou clique duas vezes na referência para ir até ela no código.
  • No menu do botão direito do mouse de uma referência, selecione os comandos Ir para local anterior ou Ir para próximo local .
  • Use as teclas Seta para cima e Seta para baixo.

Alterar agrupamentos de referência

Por padrão, as referências são agrupadas por projeto e, em seguida, por definição. No entanto, você pode alterar essa ordem de agrupamento alterando a configuração na lista suspensa Agrupar por na barra de ferramentas. Por exemplo, você pode alterá-lo da configuração padrão de Project then definition para Definition then project. Outras configurações de ordem de agrupamento também estão disponíveis.

Definição e Projeto são os dois agrupamentos padrão usados, mas você pode adicionar outros escolhendo o comando Agrupamento no menu do botão direito do mouse do item selecionado. Pode ser útil adicionar mais agrupamentos se sua solução tiver vários arquivos e caminhos.

O agrupamento não está disponível em uma lista de texto sem formatação.

Filtrar por tipo de referência no .NET

Em C# ou Visual Basic, a janela Localizar referências tem uma coluna Kind que lista o tipo de referência que foi encontrado. Você pode usar esta coluna para filtrar por tipo de referência. Selecione o ícone de filtro que aparece quando você passa o mouse sobre o cabeçalho da coluna. Você pode filtrar referências por Leitura, Gravação, Referência, Nome, Namespace e Tipo, mas somente os filtros relevantes no conjunto atual de resultados são mostrados.

Captura de ecrã na janela Localizar Referências. A coluna denominada Tipo está destacada.

Depois de aplicar um filtro ou um conjunto de filtros, você pode removê-lo facilmente usando o botão Limpar todos os filtros .

Personalizar o comportamento de visualização

Você pode definir se um arquivo é aberto no editor no local onde a referência ocorre.

Abra o painel> de Ferramentas e expanda a seção Todas as Configurações>Ambiente>Guias>Guia de Pré-visualização. Se você marcar a caixa de seleção Permitir que novos arquivos sejam abertos na guia de visualização , marque ou desmarque a caixa de seleção Visualizar arquivos selecionados em Localizar resultados .

Abra a caixa de diálogo Ferramentas>Opções e expanda a seção Ambiente>Guias e Janelas. No grupo Guia Visualizar , se você marcar a caixa de seleção Permitir que novos arquivos sejam abertos na guia Visualizar , marque ou desmarque a caixa de seleção Visualizar arquivos selecionados em Localizar resultados . Selecione OK.

Quando você seleciona essa opção, o arquivo é aberto no editor no local onde a referência ocorre. Quando a opção não é selecionada, o arquivo é aberto somente se você selecionar explicitamente Enter ou clicar duas vezes na linha.