Optionen, Text-Editor, C#, Erweitert

Mithilfe der Optionsseite Erweitert können Sie die Einstellungen für Formatierungen mithilfe des Editors, von Coderefactoring und XML-Dokumentationskommentaren für C# ändern. Wenn Sie auf die Optionsseite zugreifen möchten, klicken Sie auf Extras>Optionen und anschließend auf Text-Editor>C#>Erweitert.

Analyse

Using-Direktiven

• System-Direktiven beim Sortieren von Using-Direktiven an erster Stelle platzieren

  Wenn er ausgewählt wurde, sortiert der Befehl Remove and Sort Usings (Using-Anweisungen entfernen und sortieren) im Kontextmenü die using-Anweisungen und platziert die „System“-Namespaces ganz oben in der Liste.

  Vor dem Sortieren:

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

  Nach dem Sortieren:

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

• Using-Direktivengruppen trennen

  Wenn ausgewählt, trennt der Befehl Using-Anweisungen entfernen und sortieren im Kontextmenü die using-Anweisungen, indem er eine leere Zeile zwischen Gruppen von Anweisungen einfügt, die den gleichen Stammnamespace aufweisen.

  Vor dem Sortieren:

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

  Nach dem Sortieren:

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

• Using-Anweisungen für Typen in .NET Framework-Assemblys vorschlagen

• Using-Direktiven für Typen in NuGet-Paketen vorschlagen

  Wenn diese Optionen ausgewählt wurden, ist eine Schnellaktion zum Installieren eines NuGet-Pakets und Hinzufügen einer using-Anweisung für nicht referenzierte Typen verfügbar.

  

• Beim Einfügen fehlende using-Direktiven hinzufügen

  Bei Auswahl dieser Option werden automatisch using-Direktiven zum Code hinzugefügt, wenn Sie einen Typ in eine Datei einfügen.

Markieren

• Verweise auf Symbole unter dem Cursor markieren

  Wenn sich der Cursor innerhalb eines Symbols befindet, oder wenn Sie auf ein Symbol klicken, werden alle Instanzen dieses Symbols in der Codedatei hervorgehoben.

Gliedern

• Beim Öffnen von Dateien in Gliederungsmodus wechseln

  Wenn diese Option aktiviert ist, wird die Codedatei automatisch gegliedert. Hierdurch werden reduzierbare Codeblöcke erstellt. Beim ersten Öffnen einer Datei werden #Region-Blöcke und inaktive Codeblöcke reduziert.

• Zeilentrennzeichen zwischen Prozeduren anzeigen

  Der Text-Editor gibt den visuellen Bereich von Prozeduren an. In den CS-Quelldateien des Projekts werden an den in der folgenden Tabelle aufgeführten Positionen Linien gezeichnet:

  Position in der CS-Quelldatei	Beispiel für die Linienposition
  Nach dem Schließen eines Blockdeklarationskonstrukts	– Am Ende einer Klasse, einer Struktur, eines Moduls, einer Schnittstelle oder einer Enumeration – Nach einer Eigenschaft, Funktion oder Sub – Nicht zwischen den get- und set-Klauseln in einer Eigenschaft
  Nach mehreren Einzelzeilenkonstrukten	– Nach Import-Anweisungen, vor einer Typdefinition in einer Klassendatei – Nach den in einer Klasse deklarierten Variablen, vor jeglichen Prozeduren
  Nach Einzelzeilendeklarationen (Deklarationen, die nicht auf Blockebene erfolgen)	– Nach Importanweisungen, Inherits-Anweisungen, Variablendeklarationen, Ereignisdeklarationen, Delegatdeklarationen und Declare-Anweisungen für DLLs

Führungslinien für Blockstruktur

Aktivieren Sie diese Kontrollkästchen, um gestrichelte vertikale Linien zwischen geschweiften Klammern ( {} ) in Ihrem Code anzuzeigen. Dann können Sie leicht einzelne Codeblöcke für Ihre Deklarations- und Codeebenen erkennen.

Kommentare

• XML-Dokumentationskommentare generieren für ///

  Bei Auswahl dieser Option werden die XML-Elemente für XML-Dokumentationskommentare eingefügt, wenn Sie die ///-Kommentareinführung eingegeben haben. Weitere Informationen über die XML-Dokumentation finden Sie unter XML-Dokumentationskommentare (C#-Programmierhandbuch).

Methode extrahieren

• Don't put ref or out on custom struct (Nicht „ref“ oder „out“ auf benutzerdefinierte Struktur anfügen)

  Deaktivieren Sie dieses Kontrollkästchen, um ein unbeabsichtigtes Klonen von Strukturen zu vermeiden, indem Sie beim Extrahieren eines Ausdrucks in einen Methodenaufruf auf vorhandene Strukturobjekte verweisen.

  Beispiel

  Angenommen, in Ihrem Code sind die folgenden class- und struct-Objekte vorhanden:

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

  Wenn die Option „ref oder out nicht in benutzerdefinierter Struktur platzieren“ deaktiviert ist, generiert das Feature „Methode extrahieren“ folgende Ausgabe:

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

  Wenn die Option „ref oder out nicht in benutzerdefinierter Struktur platzieren“ aktiviert ist, generiert das Feature „Methode extrahieren“ folgende Ausgabe:

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

Inlinehinweise

• Hinweise zu Inlineparameternamen

  Wenn diese Option ausgewählt ist, werden Hinweise zu Parameternamen für Literale, Umwandlungsliterale und Objektinstanziierungen vor jedem Argument in Funktionsaufrufen eingefügt.

  

• Inlinetyphinweise

  Wenn diese Option aktiviert ist, werden für Variablen mit abgeleiteten Typen und Lambdaparametertypen Typhinweise eingefügt.

  

Vererbungsrand

• Wenn diese Option aktiviert ist, werden an den Rändern Symbole hinzugefügt, die Implementierungen und Überschreibungen Ihres Codes darstellen. Wenn Sie am Vererbungsrand auf ein Symbol klicken, werden Vererbungsoptionen für die Navigation angezeigt, die Sie auswählen können.

  

Siehe auch

• How to: Einfügen von XML-Kommentaren für die Generierung der Dokumentation
• Dokumentieren von Code mit XML-Kommentaren (C#-Leitfaden)
• Festlegen von sprachspezifischen Editoroptionen
• C#-IntelliSense