Partilhar via


Ver definições de tipo e membro

Os desenvolvedores geralmente precisam exibir as definições de código-fonte para tipos ou membros de classe que usam em seu código. No Visual Studio, os recursos Ir para Definição e Espiar Definição permitem que você exiba facilmente a definição de um tipo ou membro. Se o código-fonte não estiver disponível, o Visual Studio mostrará os metadados.

Ir para uma definição

Quando você usa o recurso Ir para definição , o Visual Studio localiza o código-fonte para o tipo ou membro selecionado. Se o código-fonte estiver em um arquivo diferente, o arquivo será aberto em uma nova janela. O Visual Studio altera o foco atual para destacar a entrada relevante.

Captura de tela que mostra como Ir para definição abre o arquivo de origem para o símbolo selecionado em uma nova janela.

Há várias maneiras de acessar Ir para Definição:

  • Posicione o cursor dentro do nome do símbolo e use a tecla de função F12

  • Clique com o botão direito do mouse no nome do símbolo e selecione Ir para definição

  • Use o atalho Ctrl+Click do teclado/mouse no nome do símbolo

Alterar atalho de ação

Pode ativar ou desativar o atalho Ctrl+Click para Ir para Definição usando a opção Ativar clique do rato para realizar Ir para Definição.

Abra o painel Ferramentas>Opções e expanda a secção Todas as Definições>Editor de Texto>Geral. Usa a lista de teclas modificadoras e define a tecla modificadora para o atalho. Escolha entre Ctrl (por defeito), Alt ou Ctrl+Alt.

Captura de ecrã das opções do Editor de Texto para a funcionalidade Peek Definition.

Abra a caixa de diálogo Ferramentas>Opções e expanda a secção Editor de Texto>Geral. Expanda a lista de teclas modificadoras Use e defina a tecla modificadora para o atalho. Escolha entre Ctrl (por defeito), Alt ou Ctrl+Alt.

Captura de ecrã das opções do Editor de Texto para a funcionalidade Ir para Definição, incluindo a definição 'Utilizar tecla modificadora'.

Veja uma definição

O recurso Peek Definition permite visualizar a definição de um tipo sem alterar o foco do seu arquivo atual no editor. Visual Studio abre uma janela de exibição Peek condensada para o arquivo de origem diretamente no contexto do seu arquivo atual. Você pode alterar o tamanho da janela de visualização do Peek para ver mais da definição original:

Captura de ecrã que mostra como Peek Definition abre o código fonte para o símbolo selecionado numa janela de visualização rápida dentro da vista atual.

Quando você fecha a janela de visualização Peek , seu arquivo de código atual permanece aberto no editor.

Há várias maneiras de acessar o Peek Definition:

  • Posicione o cursor dentro do nome do símbolo e selecione a tecla de função Alt+F12

  • Clique com o botão direito do mouse no nome do símbolo e selecione Espiar Definição

  • Use o atalho Ctrl+Click do teclado/mouse no nome do símbolo

Alterar atalho de ação

Você pode configurar o atalho de teclado/mouse Ctrl+Clique para Ir para Definição para abrir o ficheiro de código-fonte na vista Peek.

No painelFerramentas>Opções, expanda Todas as Definições>Editor de Texto>Geral e selecione a opção Definição Aberta na vista preliminar.

Captura de ecrã das opções do Editor de Texto para a funcionalidade Peek Definition.

No diálogo Opções de Ferramentas>, expande a secçãoEditor de Texto> Geral e seleciona a opção Abrir definição na vista de espreitar.

Captura de ecrã das opções do Editor de Texto para a funcionalidade Peek Definition.

Usar caminho de migalhas para vários arquivos

Ao espreitar outra definição na janela de visualização aberta Espreitar, inicia-se um trilho de navegação. Pode espreitar para a frente e para trás ao longo do caminho utilizando os círculos e setas acima da janela de visualização Espreitar :

Captura de ecrã que mostra o caminho de navegação de ficheiros de código aberto para Peek Definition e a opção de visualizar para trás.

Quando se fecha a janela Peek, o Visual Studio fecha todos os arquivos abertos no trilho de navegação. Para obter mais informações, consulte Exibir e editar código usando Peek Definition (Alt+F12).

Exibir metadados como código-fonte (C#)

Quando você tenta examinar a definição de um tipo ou membro C# e o código-fonte não está disponível, o Visual Studio mostra metadados para o símbolo. Você pode ver as declarações dos tipos e membros, mas não suas implementações. A etiqueta da guia para a janela inclui o nome do símbolo seguido por [a partir de metadados]:

Captura de tela que mostra como o Visual Studio exibe metadados somente quando o código-fonte do símbolo selecionado não está disponível.

Observação

Ao tentar examinar a definição de um tipo interno ou membro, o Visual Studio não exibe os metadados como código-fonte, independentemente de o assembly de referência ser friend. Para obter mais informações, consulte Assemblies de amigos.

Exibir definições de origem descompiladas (C#)

Quando o código-fonte do símbolo C# selecionado não estiver indisponível, você poderá definir uma opção para ver definições de origem descompiladas em vez de metadados. Use a opção Habilitar navegação para fontes descompiladas em Opções de Ferramentas>>Editor de Texto>C#>Advanced.

Captura de tela que mostra como o Visual Studio exibe o código-fonte descompilado quando a definição para o símbolo selecionado não está disponível.

Observação

Visual Studio reconstrói corpos de método usando a descompilação do ILSpy. Na primeira vez que aceder a esta funcionalidade, tem de concordar com uma declaração de exoneração de responsabilidade legal relativa ao licenciamento de software e às leis de direitos de autor e marcas registadas.