Optionen, Text-Editor, C#, Erweitert

Artikel
04/10/2023

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.

Hinweis

Möglicherweise sind nicht alle Optionen hier aufgeführt.

Analyse

Ausführen der Hintergrundcodeanalyse für ...

Wählen Sie eine der folgenden Optionen.

Option	Description
Keine	Alle Analysetools und die entsprechenden Codekorrekturen sind deaktiviert. Compilerdiagnosen und entsprechende Codekorrekturen sind für alle geöffneten Dokumente aktiviert.
Aktuelles Dokument (Standard)	Alle Analysetools werden nur für das derzeit aktive Dokument ausgeführt. Compilerdiagnosen sind für alle geöffneten Dokumente aktiviert.
Geöffnete Dokumente	Alle Analysetools und Compilerdiagnosen sind für alle geöffneten Dokumente aktiviert.
Gesamte Projektmappe	Alle Analysetools und Compilerdiagnosen sind für alle Dokumente in der Projektmappe aktiviert, unabhängig davon, ob sie geöffnet oder geschlossen sind.

Bereich für Livecodeanalyse oder Hintergrundanalyse

Konfigurieren des Bereichs für die Hintergrundanalyse für verwalteten Code. Weitere Informationen finden Sie unter Vorgehensweise: Konfigurieren des Bereichs für die Liveanalyse für verwalteten Code.

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.