Informationen zur Rechtschreibprüfung

Viele Funktionen in Visual Studio sind darauf ausgelegt, Sie dabei zu unterstützen, den gewünschten Code zu schreiben. Sie stellen sicher, dass Ihr Code kompiliert wird, und helfen Ihnen bei der Einhaltung von Codeformatierungsvorgaben. Mit der in Version 17.5 eingeführten Funktion "Rechtschreibprüfung" kann Visual Studio sogar sicherstellen, dass die Rechtschreibung korrekt ist.

Die Rechtschreibprüfung ist für eine beliebige C#-, C++- oder Markdown-Datei verfügbar. Wenn die Rechtschreibprüfung aktiviert ist, markiert Visual Studio alle Wörter, die sie als falsch geschriebene Wörter erkennt. Visual Studio schlägt auch alternative Schreibweisen vor und hilft ihnen dabei, sie zu korrigieren. Das Feature nimmt sogar eine kontextbezogene Umbenennung vor, wenn Rechtschreibfehler in Bezeichnern vorkommen, damit Ihr Code trotzdem kompiliert wird.

Sie können die Rechtschreibprüfung deaktivieren oder aktivieren, indem Sie die Schaltfläche "Rechtschreibprüfung umschalten" auf der Hauptsymbolleiste verwenden oder den Befehl "Bearbeiten>Erweitert>Rechtschreibprüfung umschalten" in der Menüleiste auswählen.

Wie verwenden Sie sie?

Wenn der Cursor sich auf einem Rechtschreibfehler befindet, enthalten die Schnellaktionen Korrekturoptionen für die Rechtschreibfehler. Die Schnellaktionen lassen sich mit der Tastenkombination Strg+. oder Alt+Eingabe aufrufen. Wenn das Kontextmenü angezeigt wird, zeigt Visual Studio drei Optionen zum Behandeln eines Rechtschreibproblems an.

Wenn eines der Wörterbücher Rechtschreibvorschläge bereitstellt, zeigt Visual Studio sie an. Wenn mehrere Wörterbücher Vorschläge bereitstellen, gruppiert Visual Studio seine Vorschläge nach Wörterbuch. Bei Zeichenfolgen und Kommentaren führt die Auswahl eines dieser Vorschläge zu einer einmaligen, direkten Ersetzung. Bei Bezeichnern in einem C++- oder C#-Dokument führt die Annahme eines Vorschlags zu einer Umgestaltung/Umbenennung, die alle Instanzen des Bezeichners aktualisiert, um sicherzustellen, dass der Code kompiliert wird.

Sie können auch das Rechtschreibproblem ignorieren. Wenn Sie das Problem ignorieren möchten, erstellt Visual Studio eine "exclusion.dic"-Datei in Ihrem AppData-Verzeichnis auf Ihrem lokalen Computer. Nachdem Sie ein Wort ignoriert haben, ignoriert die Rechtschreibprüfung es in allen Instanzen von Visual Studio.

Wie funktioniert es?

Da C#, C++ und Markdown alle Englisch als Sprache für ihre Schlüsselwörter verwenden, verwendet Visual Studio in der Regel das Wörterbuch "Englisch (Usa)" oder "en-us" für die Rechtschreibprüfung. Visual Studio überprüft die Instanz von Windows auf die verwendete Anzeigesprache, und wenn es sich nicht um "en-us" handelt, wird auch dieses Wörterbuch verwendet.

Hinweis

C# und C++ verfügen auch über zusätzliche Wörterbücher für Schlüsselwörter in diesen Sprachen, wodurch verhindert wird, dass Wörter wie "Namespace" oder "alloc" als falsch geschriebene Wörter gekennzeichnet werden.

Feedback von frühen Benutzern dieses Features informierte uns, dass Entwickler nur über Fehler im Dokument wissen möchten, mit dem sie gerade arbeiten. Als Reaktion auf dieses Feedback überprüft die Rechtschreibprüfung nur die Dokumente, die im Editor aktiv sind.

In der folgenden Tabelle sind einige der Heuristiken aufgeführt, die die Rechtschreibprüfung beim Scannen eines Codedokuments betrachtet:

Was ist im Code?	Was Visual Studio überprüft	Why?
Hallo	Hallo, Hallo	Es wird immer auf Eigennamen und gängige Substantive überprüft.
HelloWorld	Hallo, Hallo, Welt, Welt	Medial-Großbuchstaben werden verwendet, um Wortgrenzen zu markieren
Hello.World	Hallo, Hallo, Welt, Welt	Interpunktion wird als Wortgrenze verwendet.
_Hello123	Hallo, Hallo	Vorangestellte oder nachstehende Zahlen oder Satzzeichen werden entfernt.
Hello2World	Hallo, Hallo, Welt, Welt	Mediale Zahlen wie Interpunktionszeichen werden als Wortgrenze verwendet.
btnWorld	Welt, Welt	Fragmente von drei Zeichen oder weniger werden ignoriert.
helloworld	Helloworld, Helloworld	Kein Indikator zum Identifizieren von Wortgrenzen

Wenn Visual Studio eine Übereinstimmung für das Token in einem der verwendeten Wörterbücher identifiziert, gilt das Token als akzeptabel, und der Scan wird fortgesetzt. Andernfalls gilt das Token als falsch geschrieben, und Visual Studio kennzeichnet es als Rechtschreibfehler.

So passen Sie die Rechtschreibprüfung an

Sie können die Rechtschreibprüfung so anpassen, dass sie für eine Zusammenarbeitsumgebung optimiert ist. Visual Studio verwendet daher eine EditorConfig-Datei für die Konfiguration, sodass Sie das Verhalten der Rechtschreibprüfung in einem Repository steuern können.

Indem Sie eine EditorConfig-Datei konfigurieren, können Sie die Codierungsstandards einrichten, die von allen eingehalten werden sollen, wodurch Sie eine Codierungskonsistenz beibehalten können, die durch andere Methoden möglicherweise schwierig ist.

Von Bedeutung

Rechtschreibfehleroptionen sind dateispezifisch. Sie müssen angeben, auf welche Dateien Rechtschreiboptionen angewendet werden. Im folgenden Beispiel werden die Rechtschreiboptionen auf alle C#-Dateien in der Lösung angewendet:

[*.cs]

Im Folgenden finden Sie einige Beispiele und Anwendungsszenarien der Switches, die Sie in einer EditorConfig-Datei konfigurieren können:

• Auflisten der zu verwendenden Sprachen für Visual Studio. In diesem Beispiel würde Visual Studio bei der Rechtschreibprüfung nur die Wörterbücher "en-us" und "fr-fr" verwenden.

  spelling_languages = _language_[,_language_]
(Example: = en-us,fr-fr)

  Hinweis

  Installieren Sie das Sprachpaket für jede sprache, die Sie verwenden, um zu verhindern, dass Wörter von Visual Studio falsch als Rechtschreibfehler gekennzeichnet werden.

• Steuern, was Visual Studio überprüfen soll. In diesem Beispiel überprüft Visual Studio Bezeichner und Kommentare auf falsch geschriebene Wörter, überprüft aber nicht innerhalb von Zeichenfolgen.

  spelling_checkable_types = strings,identifiers,comments
(Example: = identifiers,comments)

• Steuern Sie den Schweregrad, den Visual Studio Rechtschreibfehlern in der Fehlerliste zuweist. In diesem Beispiel werden Rechtschreibfehler als Fehler angezeigt.

  spelling_error_severity = error OR warning OR information OR hint
(Example: = error)

• Erstellen Sie Ein eigenes Ausschlusswörterbuch, um Wörter anzugeben, die Sie als richtig geschrieben betrachten. In diesem Beispiel überprüft Visual Studio bei der ersten Ausführung der Rechtschreibprüfung für jede Datei in der Lösung auf eine exclusion.dic-Datei. Visual Studio überprüft dasselbe Verzeichnis der .sln-Datei für ein C#-Projekt oder im Stammverzeichnis für ein C++-Verzeichnis. Wenn keine exclusion.dic-Datei vorhanden ist, erstellt Visual Studio eine datei. Immer wenn der Benutzer sich entscheidet, ein Wort zu ignorieren, fügt Visual Studio es zur "exclusion.dic"-Datei hinzu. Visual Studio berücksichtigt jedes Wort, das in dieser "exclusion.dic"-Datei angezeigt wird, als richtig geschriebenes Wort.

  spelling_exclusion_path = absolute OR relative path to exclusion dictionary
(Example: = .\exclusion.dic)

  Hinweis

  Visual Studio verwendet das Ausschlusswörterbuch, das von der spelling_exclusion_path-Option in Ihrer EDITORCONFIG-Datei oder einer Datei „exclusion.dic“ in Ihrem Verzeichnis %localappdata%\Microsoft\VisualStudio\<Version> angegeben wird, wenn keine Option gefunden werden kann.

• Steuern, ob das sprachspezifische Standardausschlusswörterbuch verwendet wird. Diese Flagge ist voreingestellt auf "true." Alle Wörter, die dem sprachspezifischen Ausschlusswörterbuch hinzugefügt werden, werden als richtig geschrieben betrachtet. Auf "false" festgelegt, um die für C++ oder C# spezifischen Ausschlusswörterbücher zu ignorieren.

  spelling_use_default_exclusion_dictionary = true OR false
(Example: = spelling_use_default_exclusion_dictionary = false)

Hier ist ein vollständiges Beispiel:

[*.{cs,vb}]                                         //specify which files the spelling options apply to
spelling_languages = en-us,fr-fr                    //specifies the en-us and fr-fr dictionaries for use in spell checking
spelling_checkable_types = identifiers,comments     //specifies that identifiers and comments are the only checked elements
spelling_error_severity = error                     //sets severity assigned to spelling errors to error in the error list
spelling_exclusion_path = exclusion.dic             //defines a custom exclusion dictionary location and file
spelling_use_default_exclusion_dictionary = false   //ignores the language-specific default exclusion dictionary

Behandlung von Sonderfällen

Visual Studio verfügt über einige eindeutige Verhaltensweisen beim Überprüfen von Code auf Rechtschreibfehler, die sich von denen einer herkömmlichen Rechtschreibprüfung unterscheiden, die für geschriebenen Text entwickelt wurde. Einige dieser Verhaltensweisen umfassen:

• In einer Zeichenfolge, die Interpunktionszeichen enthält, z. B. 'misc', schlägt Visual Studio keine Korrektur vor, da Interpunktion in einem Bezeichner zu Code führen kann, der nicht kompiliert wird.
• Umgekehrte Schrägstriche in einer Zeichenfolge lassen das nachfolgende Zeichen von der Rechtschreibprüfung aus und behandeln den umgekehrten Schrägstrich und das nachfolgende Zeichen als Worttrennzeichen. In der Zeichenfolge hello\nworld erkennt Visual Studio beispielsweise zuerst den Backslash. Visual Studio behandelt das \n als Worttrennzeichen, das „hello“ und „world“ belässt, die jeweils einzeln überprüft werden.
• Zeichenfolgen, die URLs wie https://... oder mailto:.. enthalten, werden nicht über die gesamte Zeichenfolge hinweg einer Rechtschreibprüfung unterzogen.

Verwandte Inhalte

• Verbessern der Rechtschreibprüfung