Compartilhar via


Localizar referências em seu código

Você pode usar o comando Localizar Todas as Referências para determinar onde elementos de código específicos são referenciados em toda a base de código. No editor de código, 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 selecionar Shift+F12.

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

  • Altere o escopo da pesquisa em uma caixa de listagem suspensa. Você pode optar por pesquisar somente 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, precedida pelos títulos de coluna. Esse formato pode ser facilmente colado em uma planilha.
  • Selecione botões para ir para o próximo local ou local 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 retornados são agrupados selecionando uma opção na lista suspensa Grupo por.
  • Mantenha a janela de resultados da 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 ferramentas.
  • 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 desabilitadas na lista de texto sem formatação.
  • Pesquise cadeias de caracteres nos resultados da pesquisa inserindo texto na caixa 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 tela 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 com o 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, é possível mudar essa ordem de agrupamento, alterando a configuração na caixa de listagem suspensa Agrupar por: na barra de ferramentas. Por exemplo, você pode alterá-lo da configuração padrão do Project e, em seguida, definição para Definição e projeto. 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 outras pessoas escolhendo o comando Agrupamento no menu de clique com o 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

No C# ou no Visual Basic, a janela Localizar Referências tem uma coluna Kind que lista o tipo de referência que foi encontrado. Você pode usar essa 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 apenas os filtros relevantes no conjunto atual de resultados são exibidos.

Captura de tela da janela Localizar Referências. A coluna Kind está realçada.

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 Ferramentas>Opções e expanda a seção Todas as Configurações>Ambiente>Guias>Guia de Visualização. Se você selecionar a caixa de seleção Permitir que novos arquivos sejam abertos na caixa de seleção da guia visualização , selecione ou desmarque os arquivos selecionados na caixa de seleção Localizar Resultados .

Abra a caixa de diálogo Ferramentas>Opções, e expanda a seção Ambiente>Abas e Janelas. No grupo Guia visualização , se você selecionar a caixa de seleção Permitir que novos arquivos sejam abertos na caixa de seleção da guia visualização , selecione ou desmarque os arquivos selecionados na caixa de seleção 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 estiver selecionada, o arquivo será aberto somente se você selecionar Explicitamente Enter ou clicar duas vezes na linha.