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. | – |
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é.)
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.
