Regras de linguagem

As regras de linguagem do estilo de código afetam como várias construções de linguagens de programação do .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 da opção EditorConfig para essas regras começam com o dotnet_style_ prefixo.
  • Regras de estilo c#: regras que são específicas apenas para a linguagem C#. Os nomes da opção EditorConfig para essas regras começam com o csharp_style_ prefixo.
  • regras de estilo de Visual Basic: regras que são específicas somente para o idioma Visual Bsic. Os nomes da opção EditorConfig para essas regras começam com o visual_basic_style_ prefixo.

Formato da opção

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

option_name = value(Visual Studio 2019 versão 16,9 Preview 2 e posterior)

ou

option_name = value:severity

  • Valor

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

  • severidade (opcional no Visual Studio 2019 versão 16,9 Preview 2 e versões posteriores)

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

    Para impor regras de estilo de código no momento da compilação, defina a severidade usando a sintaxe de configuração de severidade baseada em ID de regra para analisadores em vez disso. A sintaxe assume a forma dotnet_diagnostic.<rule ID>.severity = <severity> , por exemplo, dotnet_diagnostic.IDE0040.severity = silent . Para obter mais informações, consulte nível de severidade.

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 de ações rápidas após a ocorrência de uma violação de estilo. Para obter mais informações, consulte Configurar automaticamente estilos de código em 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 somente à linguagem C#.

regras de estilo de Visual Basic

as regras de estilo nesta seção são aplicáveis somente ao idioma Visual Basic.

Confira também