Možnosti, textový editor, C#, upřesnit

Článek
01/13/2024

Na stránce Upřesnit možnosti můžete upravit nastavení pro formátování editoru, refaktoring kódu a komentáře dokumentace XML pro jazyk C#. Na tuto stránku možností se dostanete tak, že zvolíte Možnosti nástrojů>a pak zvolíte Textový editor>C#>Upřesnit.

Poznámka:

Tady nemusí být uvedené všechny možnosti.

Analýza

Spusťte analýzu kódu na pozadí pro ...

Zvolte jednu z následujících možností.

Možnost	popis
Nic	Všechny analyzátory a odpovídající opravy kódu jsou zakázané. Diagnostika kompilátoru a odpovídající opravy kódu jsou povoleny ve všech otevřených dokumentech.
Aktuální dokument (výchozí)	Všechny analyzátory běží jenom v aktuálně aktivním dokumentu. Diagnostika kompilátoru je povolená u všech otevřených dokumentů.
Otevření dokumentů	Všechny analyzátory a diagnostika kompilátoru jsou povolené ve všech otevřených dokumentech.
Celé řešení	Všechny analyzátory a diagnostika kompilátoru jsou povoleny pro všechny dokumenty v řešení bez ohledu na to, jestli jsou otevřené nebo zavřené.

Rozsah analýzy živého kódu nebo analýzy na pozadí

Nakonfigurujte obor analýzy na pozadí pro spravovaný kód. Další informace naleznete v tématu Postupy: Konfigurace rozsahu živé analýzy kódu pro spravovaný kód.

Using – direktivy

Při řazení pomocí direktivy System nejprve umístěte direktivy System.

Pokud je tato možnost vybrána, příkaz Remove and Sort Usings v nabídce kliknutí pravým tlačítkem seřadí using direktivy a umístí obory názvů System v horní části seznamu.

Před řazením:
```
using AutoMapper;
using FluentValidation;
using System.Collections.Generic;
using System.Linq;
using Newtonsoft.Json;
using System;
```
Po řazení:
```
using System;
using System.Collections.Generic;
using System.Linq;
using AutoMapper;
using FluentValidation;
using Newtonsoft.Json;
```
Oddělení pomocí skupin direktiv

Pokud je tato možnost vybrána, příkaz Remove and Sort Usings v nabídce zobrazené po kliknutí pravým tlačítkem odděluje direktivy using vložením prázdného řádku mezi skupiny direktiv, které mají stejný kořenový obor názvů.

Před řazením:
```
using AutoMapper;
using FluentValidation;
using System.Collections.Generic;
using System.Linq;
using Newtonsoft.Json;
using System;
```
Po řazení:
```
using AutoMapper;

using FluentValidation;

using Newtonsoft.Json;

using System;
using System.Collections.Generic;
using System.Linq;
```
Návrh použití pro typy v sestaveních rozhraní .NET Framework
Návrhy použití pro typy v balíčcích NuGet

Při výběru těchto možností je k dispozici rychlá akce pro instalaci balíčku NuGet a přidání using direktivy pro nerozpoznané typy.
Přidání chybějících direktiv using při vložení

Při výběru using této možnosti se direktivy při vložení typu do souboru automaticky přidají do kódu.

Zvýraznění

Zvýraznění odkazů na symbol pod kurzorem

Když je kurzor umístěn uvnitř symbolu nebo když kliknete na symbol, zvýrazní se všechny výskyty tohoto symbolu v souboru kódu.

Osnova

Přechod do režimu osnovy při otevření souborů

Při výběru automaticky nastíní soubor kódu, který vytvoří sbalitelné bloky kódu. Při prvním otevření souboru #regions bloky a neaktivní bloky kódu se sbalí.

Zobrazit oddělovače řádků procedury

Textový editor označuje vizuální rozsah procedur. Čára se nakreslí ve zdrojových souborech .cs projektu v umístěních uvedených v následující tabulce:

Umístění ve zdrojovém souboru .cs	Příklad umístění řádku
Po uzavření konstruktoru deklarace bloku	- Na konci třídy, struktury, modulu, rozhraní nebo výčtu – Po vlastnosti, funkci nebo pod - Ne mezi klauzulemi get a set ve vlastnosti
Za sadou jednořádkových konstruktorů	- Po příkazech importu před definicí typu v souboru třídy - Po proměnných deklarovaných ve třídě před všemi procedurami
Po jednořádkových deklaracích (deklarace na úrovni bez bloku)	- Následující příkazy importu, dědí příkazy, deklarace proměnných, deklarace událostí, delegované deklarace a příkazy dll deklarací.

Vodítka struktury bloku

Zaškrtnutím těchto políček zobrazíte tečkované svislé čáry mezi složenými závorkami ({}) v kódu. Pak můžete snadno zobrazit jednotlivé bloky kódu pro úroveň deklarace a konstrukty na úrovni kódu.

Poznámky

Generování komentářů dokumentace XML pro ///

Po výběru vloží elementy XML pro komentáře dokumentace XML po zadání úvodu /// komentáře. Další informace o dokumentaci XML naleznete v tématu Komentáře dokumentace XML (Průvodce programováním v C#).

extrahování metody

Neumisťujte ref ani ven do vlastní struktury

Zrušte zaškrtnutí tohoto políčka, abyste se vyhnuli potenciálně neúmyslnému klonování struktur tím, že při extrahování výrazu do volání metody refencuje existující objekty struktury.

Příklad

Měl by existovat následující class kód a struct ve vašem kódu:

public struct CustomStruct
{
    private int Count;

    public int Bump => ++Count;
}

public class CustomClass
{
    public void DoIt()
    {
       CustomStruct cs = new CustomStruct();
       int i = 0;

       i += cs.Bump;   // select this line
    }
}

Pokud není zaškrtnutá možnost Nevyložit ref nebo mimo vlastní strukturu, vygeneruje funkce Extract method následující:

public class CustomClass
{
    public void DoIt()
    {
       CustomStruct cs = new CustomStruct();
       int i = 0;

       NewMethod(ref cs, ref i);
    }

    private static void NewMethod(ref CustomStruct cs, ref int i)
       => i += cs.Bump;
}

Pokud je zaškrtnutá možnost "Nevkládat ref nebo ven na vlastní strukturu", pak funkce "Extract method" vygeneruje následující:

public class CustomClass
{
    public void DoIt()
    {
       CustomStruct cs = new CustomStruct();
       int i = 0;

       i = NewMethod(cs, i);
    }

    private static int NewMethod(CustomStruct cs, int i)
    {
       i += cs.Bump;
       return i;
    }
}

Vložené rady

Nápovědy k názvům vložených parametrů

Při výběru vloží nápovědu pro názvy parametrů pro literály, přetypování literálů a vytváření instancí objektů před každým argumentem ve voláních funkce.
Nápověda pro vložený typ

Při výběru vloží nápovědu k typům pro proměnné s odvozenými typy a typy parametrů lambda.

Okraj dědičnosti

Po výběru přidá ikony na okraje představující implementace a přepsání kódu. Kliknutím na ikony okrajů dědičnosti se zobrazí možnosti dědičnosti, na které můžete přejít.