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

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.

Analýza

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.

  

Viz také

• Postupy: Vložení komentářů XML pro generování dokumentace
• Zdokumentujte kód pomocí komentářů XML (Průvodce jazykem C#)
• Nastavení možností editoru pro konkrétní jazyk
• C# IntelliSense