Regras de linguagem

As regras de linguagem de estilo de código afetam como várias construções de linguagens de programação .NET, por exemplo, modificadores e parênteses, são usadas. As regras se enquadram nas seguintes categorias:

  • Regras de estilo .NET: regras que se aplicam a C# e Visual Basic. Os nomes das opções para essas regras começam com o prefixo dotnet_style_.
  • Regras de estilo C#: regras específicas do código C#. Os nomes das opções para essas regras começam com o prefixo csharp_style_.
  • Regras de estilo do Visual Basic: regras específicas do código do Visual Basic. Os nomes das opções para essas regras começam com o prefixo visual_basic_style_.

Formato de opção

As opções para regras de idioma podem ser especificadas em um arquivo de configuração com o seguinte formato:

option_name = value (Visual Studio 2019 versão 16.9 e posterior)

ou

option_name = value:severity

  • Valor

    Para cada regra de linguagem, você especifica um valor que define se ou quando preferir o estilo. Muitas regras aceitam um valor de true (prefira este estilo) ou false (não prefira este estilo). Outras regras aceitam valores como when_on_single_line ou never.

  • Gravidade (opcional no Visual Studio 2019 versão 16.9 e versões posteriores)

    A segunda parte da regra especifica o nível de gravidade da regra. Quando especificado dessa forma, a configuração de gravidade é respeitada apenas dentro de IDEs de desenvolvimento, como o Visual Studio. Ele não é respeitado durante a compilação.

    Para impor regras de estilo de código em tempo de compilação, defina a gravidade usando a sintaxe de configuração de gravidade baseada em ID de regra para analisadores. A sintaxe assume o formato dotnet_diagnostic.<rule ID>.severity = <severity>, por exemplo, dotnet_diagnostic.IDE0040.severity = none. Para obter mais informações, consulte nível de gravidade.

Dica

A partir do Visual Studio 2019 versão 16.3, você pode configurar regras de estilo de código no menu de lâmpada Ações rápidas após ocorrer uma violação de estilo. Para obter mais informações, consulte Configurar estilos de código automaticamente no Visual Studio.

Regras de estilo .NET

As regras de estilo nesta seção são aplicáveis tanto para C# quanto para Visual Basic.

Regras de estilo C#

As regras de estilo nesta seção são aplicáveis apenas à linguagem C#.

Regras de estilo do Visual Basic

As regras de estilo nesta seção são aplicáveis apenas à linguagem Visual Basic.

Confira também