RefatoraçãoRefactoring

Refatorar o código é uma maneira para reorganizar, reestruturar e esclarecer o código existente e garantir que o comportamento geral do código não se altere.Refactoring code is a way to rearrange, restructure, and clarify existing code while ensuring that the overall behavior of the code doesn't change.

Refatorar produz uma base de código mais íntegra, tornando-a mais utilizável, saudável, legível e fácil de manter tanto para você quanto para qualquer outro desenvolvedor ou usuário que poderia consultar o código.Refactoring produces a healthier code base, making it more useable, readable, and maintainable for you or any other developer or user that might refer to the code.

A integração do Visual Studio para Mac com o Roslyn, a plataforma de compilador .NET do software livre da Microsoft, permite realizar mais operações de refatoração.Visual Studio for Mac's integration with Roslyn, Microsoft's open-source .NET compiler platform, allows for more refactoring operations.

RenomearRenaming

O comando de refatoração Renomear pode ser usado em qualquer identificador de código (por exemplo, um nome de classe, nome de propriedade, etc.) para localizar todas as ocorrências do identificador em questão e alterá-las.The Rename refactoring command can be used on any code identifier (for example, a class name, property name etc.) to find all occurrences of that identifier and change them. Para renomear um símbolo, clique com o botão direito do mouse nele e escolha Renomear... ou use a associação de teclas Cmd (⌘) + R:To rename a symbol, right-click on it and choose Rename..., or use the Cmd (⌘) + R key binding:

Renomear um item de menu

Isso destaca o símbolo e todas as referências a ele.This highlights the symbol and any references to it. Quando você começar a digitar um novo nome, ele será alterado automaticamente em todas as referências no código e você poderá confirmar as alterações pressionando Enter:When you start typing a new name it automatically changes all references in your code, and you can commit your changes by pressing Enter:

Renomear e identificador

Ações rápidasQuick actions

As Ações Rápidas permitem refatorar, gerar ou, de outro modo, modificar o código de maneira fácil com uma única ação.Quick Actions let you easily refactor, generate, or otherwise modify code with a single action.

É possível usar as Ações rápidas para:Quick Actions can be used to:

  • Aplicar uma correção de código para uma violação de regra do analisador de códigoApply a code fix for a code analyzer rule violation
  • Suprimir uma violação de regra do analisador de códigoSuppress a code analyzer rule violation
  • Aplicar uma refatoração (por exemplo, embutir uma variável temporária)Apply a refactoring (for example, inline a temporary variable)
  • Gerar um código (por exemplo, introduzir uma variável local)Generate code (for example, introduce a local variable)

Agora, as correções rápidas podem ser aplicadas usando os ícones de lâmpada ícone de lâmpada ou chave de fenda ícone chave de fenda ou pressionando Opção (⌥)+Enter quando o cursor estiver em uma linha de código em que a ação está disponível.Quick Actions can be applied by using the light bulb light bulb icon or screwdriver screwdriver icon icons, or by pressing Option (⌥)+Enter when your cursor is on a line of code for which an action is available. Você verá uma lâmpada erro ícone de lâmpada de erro se houver um rabisco vermelho, indicando um erro e o Visual Studio terá uma solução disponível para esse erro.You'll see an error light bulb error light bulb icon if there is a red squiggle indicating an error, and Visual Studio has a fix available for that error.

Para qualquer idioma, terceiros podem oferecer diagnósticos e sugestões personalizados, por exemplo, como parte de um SDK, e as lâmpadas do Visual Studio são acesas de acordo com essas regras.For any language, third parties can provide custom diagnostics and suggestions, for example as part of an SDK, and Visual Studio light bulbs light up based on those rules.

Ícones de Ação RápidaQuick Action Icons

O ícone exibido quando uma Ação Rápida fica disponível oferece uma indicação do tipo de correção ou que a refatoração está disponível.The icon that appears when a Quick Action is available gives an indication of the type of fix or refactoring that's available. O ícone de chave de fenda ícone de chave de fenda indica apenas que há ações disponíveis para alterar o código, mas você não deve necessariamente usá-las.The screwdriver screwdriver icon icon indicates just that there are actions available to change the code, but you shouldn't necessarily use them. O ícone de lâmpada amarela ícone de lâmpada indica que há ações disponíveis que você deve executar para melhorar o seu código.The yellow light bulb light bulb icon icon indicates there are actions available that you should do to improve your code. O ícone de lâmpada de erro ícone de lâmpada de erro indica que há uma ação disponível que corrige um erro no seu código.The error light bulb error light bulb icon icon indicates there's an action available that fixes an error in your code.

Para ver uma lâmpada ou chave de fendaTo see a light bulb or screwdriver

  • Se uma correção estiver disponível, lâmpadas serão exibidas espontaneamente quando você passar o mouse no local de um erro.If a fix is available, light bulbs spontaneously appear when you hover the mouse at the location of an error.

    Lâmpada com o mouse focalizando

  • Lâmpadas e chaves de fenda são exibidas na margem esquerda do editor quando você move o cursor para uma linha de código para o qual uma Ação Rápida está disponível.Light bulbs and screwdrivers appear in the left margin of the editor when you move the caret into a line of code for which a Quick Action is available.

  • Pressione Opção (⌥)+Enter em qualquer lugar em uma linha para ver uma lista de Ações Rápidas e refatorações disponíveis.Press Option (⌥)+Enter anywhere on a line to see a list of available Quick Actions and refactorings.

Exibir itens de contexto

Focalizar uma das ações de contexto fornecerá uma visualização do que será adicionado ou removido do código.Hovering over any of the context actions provides you with a preview of what will be added or removed from your code.

Itens de contexto Option Enter

Para habilitar essas opções, você deverá selecionar Habilitar a análise de código-fonte de arquivos abertos nas opções de Visual Studio para Mac > Preferências > Editor de Texto > Análise de Código-Fonte:To enable these options, you must select Enable source analysis of open files in the options Visual Studio for Mac > Preferences > Text Editor > Source Analysis:

Habilitar a análise de código-fonte

Há mais de 100 ações possíveis que podem ser sugeridas, as quais são habilitadas ou desabilitadas navegando para Visual Studio para Mac > Preferências > Análise de código-fonte > C# > Ações de Código e marcando ou desmarcando a caixa ao lado da ação:There are over 100 possible actions that can be suggested, which are enabled or disabled by browsing to Visual Studio for Mac > Preferences > Source Analysis > C# > Code Actions and selecting or unselecting the box next to the action:

Ações da Análise de código-fonte C#

Ações rápidas comunsCommon quick actions

Você pode aprender mais sobre as ações rápidas comuns no artigo Ações Rápidas Comuns.You can learn more about common quick actions in the Common Quick Actions article.

Análise de código-fonteSource analysis

A análise de código-fonte examinará o código em tempo real sublinhando possíveis erros e violações de estilo e fornecendo correções automáticas como ações de contexto.Source analysis analyzes your code on the fly by underlining potential errors and style violations, and providing auto fixes as context actions.

Você pode exibir todos os resultados da análise de código-fonte para qualquer arquivo a qualquer momento exibindo a barra de rolagem à direita do editor de texto:You can view all results of the source analysis for any file, at any time, by viewing the scroll bar on the right side of the text editor:

Barra lateral da Análise de código-fonte

Se você clicar no círculo na parte superior, poderá percorrer cada sugestão, com os problemas de gravidade mais alto sendo mostrados primeiro.If you click on the circle at the top, you can iterate through each suggestion, with the highest severity issues showing first. Focalizar um resultado ou linha individual exibirá o problema que poderá ser corrigido por meio de ações de contexto:Hovering over an individual result or line displays the issue, which can be fixed through context actions:

Item da análise de código-fonte

Consulte tambémSee also