Reguły języka

Reguły języka stylu kodu wpływają na sposób, w jaki są używane różne konstrukcje języków programowania .NET, na przykład modyfikatory i nawiasy. Reguły można poszczególnych kategorii:

  • Reguły stylu .NET:reguły, które mają zastosowanie zarówno do języka C#, jak i Visual Basic. Nazwy opcji EditorConfig dla tych reguł zaczynają się dotnet_style_ prefiksem.
  • Reguły stylu języka C#:reguły specyficzne tylko dla języka C#. Nazwy opcji EditorConfig dla tych reguł zaczynają się csharp_style_ prefiksem.
  • Visual Basic stylu:reguły specyficzne tylko dla języka Visual Bsic. Nazwy opcji EditorConfig dla tych reguł zaczynają się visual_basic_style_ prefiksem.

Format opcji

Opcje reguł języka można określić w pliku EditorConfig w następującym formacie:

option_name = value(Visual Studio 2019 w wersji 16.9 (wersja zapoznawcza 2 lub nowsza)

lub

option_name = value:severity

  • Wartość

    Dla każdej reguły języka należy określić wartość, która definiuje, czy lub kiedy należy preferować styl. Wiele reguł akceptuje wartość true (preferuj ten styl) false lub (nie preferuj tego stylu). Inne reguły akceptują wartości, takie when_on_single_line jak lub never .

  • Ważność (opcjonalnie w Visual Studio 2019 w wersji 16.9 (wersja zapoznawcza 2) i nowszych)

    Druga część reguły określa poziom ważności reguły. Jeśli zostanie określone w ten sposób, ustawienie ważności będzie przestrzegane tylko w programowych projektowych projektach, takich jak Visual Studio. Nie jest on przestrzegany podczas kompilacji.

    Aby wymusić reguły stylu kodu w czasie kompilacji, należy ustawić ważność przy użyciu składni konfiguracji ważności opartej na identyfikatorze reguły dla analizatorów. Składnia ma postać dotnet_diagnostic.<rule ID>.severity = <severity> , na przykład dotnet_diagnostic.IDE0040.severity = silent . Aby uzyskać więcej informacji, zobacz poziom ważności.

Porada

Począwszy od Visual Studio 2019 r. w wersji 16.3, można skonfigurować reguły stylu kodu z menu żarówki Szybkie akcje po naruszeniu stylu. Aby uzyskać więcej informacji, zobacz Automatyczne konfigurowanie stylów kodu w Visual Studio.

Reguły stylu .NET

Reguły stylu w tej sekcji mają zastosowanie zarówno do języka C#, jak i Visual Basic.

Reguły stylu języka C#

Reguły stylu w tej sekcji mają zastosowanie tylko do języka C#.

Visual Basic reguł stylu

Reguły stylów w tej sekcji mają zastosowanie tylko Visual Basic języku.

Zobacz też