Dialogové okno Možnosti: Formátování stylu kódu > v textovém editoru > > C#

Pomocí stránky Možnosti formátování a jejích podstránek ( Odsazení, Nové řádky, Mezery a Zalamování ) můžete nastavit možnosti formátování kódu v editoru kódu.

Na tuto stránku možností se můžete dostat tak, že na > řádku nabídek zvolíte Nástroje Možnosti. V dialogovém okně Možnosti zvolte Textový editor Formátování stylu kódu > > > C#.

Tip

Na podstráncích Odsazení, Nové řádky, Mezery a Zabalení se v dolní části zobrazí okno náhledu, které ukazuje účinek jednotlivých možností. Pokud chcete použít okno náhledu, vyberte možnost formátování. V okně náhledu se zobrazí příklad vybrané možnosti. Když změníte nastavení výběrem přepínače nebo zaškrtávacího políčka, okno náhledu se aktualizuje a zobrazí vliv nového nastavení.

Stránka Formátování (Obecné)

Obecná nastavení

Tato nastavení mají vliv na to, kdy editor kódu používá možnosti formátování kódu.

Popisek Description
Automatické formátování při psaní Když zrušíte výběr, příkaz format u možností ; a format block u } jsou zakázané.
Automaticky formátovat příkaz pro ; Pokud je tato možnost vybraná, formátuje příkazy při dokončení podle možností formátování vybraných pro editor.
Automatické formátování bloku pro } Pokud je tato možnost vybraná, formátuje bloky kódu podle možností formátování vybraných pro editor ihned po dokončení bloku kódu.
Automatické formátování při vrácení Pokud je tato možnost vybraná, formátuje text při stisknutí klávesy Enter tak, aby se vešel do možností formátování vybraných pro editor.
Automatické formátování při vložení Když je tato možnost vybraná, formátuje text, který je v editoru vovaný, aby se vešel do možností formátování vybraných pro editor.

Pokud jste dříve použili nastavení stylu kódu pro soubory C# pomocí příkazu Formátovat dokument v Visual Studio 2017, tato funkce je teď dostupná jako Vyčištění kódu.

Formátování nastavení dokumentu

Tato nastavení konfiguruje příkaz Format Document (Formátovat dokument) tak, aby u souboru prováděl další vyčištění kódu. Další informace o tom, jak se tato nastavení používají, najdete v tématu Příkaz Formátovat dokument.

Popisek Description Odpovídající EditorConfig a Nástroje > možnosti
Použití všech pravidel formátování jazyka C# (odsazení, zabalení, mezery) Příkaz Formátovat dokument vždy řeší problémy s formátováním. Toto nastavení nelze změnit. Základní možnosti EditorConfig
Možnosti formátování .NET EditorConfig

Nástroje > Možnosti > Textový editor > C# > Formátování > [odsazení, nové řádky, mezery nebo zalamování]
Vyčištění sčítání kódu během formátování Pokud je tato možnost vybraná, aplikuje opravy pro pravidla uvedená níže v příkazu Edit.FormatDocument.
Odebrání nepotřebných použití Když je tato možnost vybraná, using odebere nepotřebné direktivy při aktivaci Edit.FormatDocument.
Řazení using Pokud je tato možnost using vybraná, seřadí direktivy při aktivaci edit.formatdocument. dotnet_sort_system_directives_first

Nástroje > Možnosti > Textový editor > C# > Upřesnit > Při řazení direktiv using nejprve umístěte direktivy System.
Přidání nebo odebrání složených závorek pro jedno řádky řídicích příkazů Když je tato možnost vybraná, přidá nebo odebere složené závorky z jedno řádkové řídicí příkazy, když se aktivuje Edit.FormatDocument. csharp_prefer_braces

Nástroje > Možnosti > Textový editor > C# > Styl kódu > Předvolby bloku kódu > Upřednostňovat složené závorky
Přidání modifikátorů přístupnosti Pokud je tato možnost vybraná, při aktivaci Edit.FormatDocument přidá chybějící modifikátory usnadnění. dotnet_style_require_accessibility_modifiers
Řazení modifikátorů přístupnosti Pokud je tato možnost vybraná, seřadí modifikátory usnadnění při aktivaci Edit.FormatDocument. csharp_preferred_modifier_order
visual_basic_preferred_modifier_order
Použití předvoleb těla výrazu nebo bloku Pokud je tato možnost vybraná, převede členy s textem výrazu na těla bloků nebo naopak, když se aktivuje Edit.FormatDocument. Možnosti EditorConfig člena s výrazem

Nástroje > Možnosti > Textový editor > C# > Styl kódu > Předvolby výrazů > Tělo výrazu použijte pro metody, konstruktory atd.
Použití předvoleb implicitního/explicitního typu Pokud je tato možnost vybraná, převede se při aktivaci var Edit.FormatDocument na explicitní typ nebo naopak. Možnosti EditorConfig explicitního typu

Nástroje > Možnosti > Textový editor > C# > Styl kódu > Předvolby 'var'
Použití vřádkových předvoleb proměnných "out" Pokud je tato možnost vybraná, zamíchá proměnné tam, kde je to možné, když out se aktivuje Edit.FormatDocument. csharp_style_inlined_variable_declaration

Nástroje > Možnosti > Textový editor > C# > Styl kódu > Předvolby proměnných > Preferovat deklaraci vkládaných proměnných
Použití předvoleb typu jazyka nebo architektury Pokud je tato možnost vybraná, převede jazykové typy na typy architektury nebo naopak, když se aktivuje Edit.FormatDocument. dotnet_style_predefined_type_for_locals_parameters_members
dotnet_style_predefined_type_for_member_access

Nástroje > Možnosti > Textový editor > C# > Styl kódu > předvolby předdefinovaného typu
Použití předvoleb inicializace objektu nebo kolekce Pokud je tato možnost vybraná, použije inicializátory objektů a kolekcí tam, kde je to možné, když se aktivuje Edit.FormatDocument. dotnet_style_object_initializer
dotnet_style_collection_initializer

Nástroje > Možnosti > Textový editor > C# > Styl kódu > Předvolby výrazů > Preferovat inicializátor objektů nebo inicializátor kolekce preferovat
Použití předvoleb kvalifikace "this". Pokud je tato možnost this. vybraná, použije předvolby při aktivaci Edit.FormatDocument. Tento. možnosti kvalifikace EditorConfig

Nástroje > Možnosti > Textový editor > C# > Styl kódu > Předvolby 'this.'
Pokud je to možné, u soukromých polí čtěte jen pro čtení. Pokud je tato možnost vybraná, vytvoří soukromá pole tam, kde je to možné, když se aktivuje readonly Edit.FormatDocument. dotnet_style_readonly_field

Nástroje > Možnosti > Textový editor > C# > Styl kódu > Předvolby polí > Preferovat jen pro čtení
Odebrání nepotřebných přetypování Pokud je tato možnost vybraná, odebere nepotřebná přetypování tam, kde je to možné, když se aktivuje Edit.FormatDocument.
Odebrání nepoužívaných proměnných Pokud je tato možnost vybraná, odebere proměnné, které se nepoužívané při aktivaci Edit.FormatDocument.

Nastavení vyčištění kódu pro jazyk C# v Visual Studio

Stránka odsazení

Možnosti odsazení na této stránce se použijí při automatickém formátování kódu. Jedním z příkladů, kdy je kód automaticky formátovaný, je vložení kódu do souboru, zatímco je vybrána možnost Automaticky formátovat při vložení. (Možnost Automaticky formátovat při vložení je v části Formátování. > Obecné.)

Možnosti odsazení textového editoru v C# v Visual Studio

Tip

Na > > stránce Možnosti na kartě C# editoru textu se nacházejí taky možnosti odsazení. Tyto možnosti určují, kde Editor kódu umístí kurzor po stisknutí klávesy ENTER na konci řádku.

Karty editoru textu v C# – možnosti v Visual Studio

Viz také