Alternativ, Textredigeraren, C#, Avancerat

Använd sidan Avancerade alternativ om du vill ändra inställningarna för redigerarformatering, kodrefaktorisering och XML-dokumentationskommenterar för C#. Om du vill komma åt den här alternativsidan väljer du Verktygsalternativ> och sedan Textredigeraren>>.

Analys

Använda direktiv

• Placera systemdirektiv först när du sorterar med hjälp av

  När du väljer väljer du kommandot Ta bort och sortera användningar på snabbmenyn och sorterar direktiven using och placerar namnrymderna "System" överst i listan.

  Innan du sorterar:

  using AutoMapper;
  using FluentValidation;
  using System.Collections.Generic;
  using System.Linq;
  using Newtonsoft.Json;
  using System;
  

  Efter sortering:

  using System;
  using System.Collections.Generic;
  using System.Linq;
  using AutoMapper;
  using FluentValidation;
  using Newtonsoft.Json;
  

• Avgränsa med hjälp av direktivgrupper

  När du väljer kommandot Ta bort och Sortera användningar på högerklicksmenyn separeras using direktiven genom att infoga en tom rad mellan grupper av direktiv som har samma rotnamnområde.

  Innan du sorterar:

  using AutoMapper;
  using FluentValidation;
  using System.Collections.Generic;
  using System.Linq;
  using Newtonsoft.Json;
  using System;
  

  Efter sortering:

  using AutoMapper;
  
  using FluentValidation;
  
  using Newtonsoft.Json;
  
  using System;
  using System.Collections.Generic;
  using System.Linq;
  

• Föreslå användning för typer i .NET Framework-sammansättningar

• Föreslå användning för typer i NuGet-paket

  När de här alternativen har valts är en snabbåtgärd tillgänglig för att installera ett NuGet-paket och lägga till ett using direktiv för ouppnåeliga typer.

  

• Lägg till saknade med hjälp av direktiv vid klistra in

  När det här alternativet har valts using läggs direktiv automatiskt till i koden när du klistrar in en typ i en fil.

Överstrykning

• Markera referenser till symbolen under markören

  När markören placeras inuti en symbol, eller när du klickar på en symbol, markeras alla instanser av symbolen i kodfilen.

Skisserar

• Ange dispositionsläge när filer öppnas

  När du väljer det här alternativet visas kodfilen automatiskt, vilket skapar komprimerbara kodblock. Första gången en fil öppnas döljs #regions block och inaktiva kodblock.

• Visa procedurradavgränsare

  Textredigeraren anger det visuella omfånget för procedurer. En rad ritas i .cs källfiler för projektet på platser som anges i följande tabell:

  Plats i .cs källfil	Exempel på radplats
  Efter stängningen av en blockdeklarationskonstruktion	– I slutet av en klass, struktur, modul, gränssnitt eller uppräkning – Efter en egenskap, funktion eller under – Inte mellan get- och set-satserna i en egenskap
  Efter en uppsättning enradskonstruktioner	– Efter importinstruktionerna, före en typdefinition i en klassfil – Efter variabler som deklarerats i en klass, innan några procedurer
  Efter enradsdeklarationer (icke-blocknivådeklarationer)	– Följande importinstruktioner, ärver instruktioner, variabeldeklarationer, händelsedeklarationer, delegatdeklarationer och DLL-deklarerande instruktioner

Blockstrukturstödlinjer

Markera de här kryssrutorna om du vill visa prickade lodräta linjer mellan klammerparenteserna ({}) i koden. Du kan sedan enkelt se enskilda kodblock för konstruktionerna på deklarationsnivå och kodnivå.

Kommentarer

• Generera XML-dokumentationskommentar för ///

  När du har valt detta infogar du XML-elementen för XML-dokumentationskommenterar när du har angett kommentarsintroduktionen /// . Mer information om XML-dokumentation finns i Kommentarer till XML-dokumentation (C#-programmeringsguide).

Extrahera metodfunktion

• Placera inte referens eller ut på anpassad struct

  Avmarkera den här kryssrutan för att undvika potentiellt oavsiktlig kloning av structs genom att referera till befintliga struct-objekt när du extraherar ett uttryck till ett metodanrop.

  Exempel

  Förmodar att följande class och struct finns i koden:

  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
      }
  }
  

  Om alternativet "Placera inte referens eller ut på anpassad struct" är avmarkerat genererar funktionen "Extrahera metod" följande:

  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;
  }
  

  Om alternativet "Placera inte referens eller ut på anpassad struct" är markerat genererar funktionen "Extrahera metod" följande:

  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;
      }
  }
  

Infogade tips

• Tips om infogade parameternamn

  När du väljer infogar du tips om parameternamn för literaler, gjutna literaler och objektinstansiering före varje argument i funktionsanrop.

  

• Tips för infogad typ

  När du väljer infogar du typtips för variabler med härledda typer och lambda-parametertyper.

  

Arvsmarginal

• När du väljer lägger du till ikoner i marginalerna som representerar kodens implementeringar och åsidosättningar. Om du klickar på ikonerna för arvsmarginal visas arvsalternativ som du kan välja att navigera till.

  

Se även

• Anvisningar: Infoga XML-kommentarer för generering av dokumentation
• Dokumentera koden med XML-kommentarer (C#-guide)
• Ange språkspecifika redigeringsalternativ
• C# IntelliSense