Verwenden des Code-Editors mit C#

Artikel
06/19/2023

In dieser zehnminütigen Einführung in den Code-Editor von Visual Studio wird Code zu einer Datei hinzugefügt, um zu veranschaulichen, inwiefern Visual Studio das Schreiben, Navigieren und Verstehen von C#-Code vereinfacht.

Wenn Sie Visual Studio noch nicht installiert haben, können Sie es auf der Seite Visual Studio-Downloads kostenlos herunterladen.

In diesem Artikel wird davon ausgegangen, dass Sie bereits mit C# vertraut sind. Wenn das nicht der Fall ist, sollten Sie sich zunächst Tutorials wie Erste Schritte mit C# und ASP.NET Core in Visual Studio ansehen.

Tipp

Damit Sie die in diesem Artikel beschriebenen Vorgänge ausführen können, vergewissern Sie sich, dass Sie für Visual Studio die C#-Einstellungen ausgewählt haben. Weitere Informationen zum Auswählen von Einstellungen für die integrierte Entwicklungsumgebung (Integrated Development Environment, IDE) finden Sie unter Select environment settings (Auswählen von Umgebungseinstellungen).

Erstellen einer neuen Codedatei

Beginnen Sie mit dem Erstellen einer neuen Datei, und fügen Sie dieser Code hinzu.

Öffnen Sie Visual Studio. Drücken Sie ESC, oder klicken Sie im Startfenster auf Ohne Code fortfahren, um die Entwicklungsumgebung zu öffnen.
Wählen Sie im Menü Datei auf der Menüleiste Neu>Datei aus, oder drücken sie STRG+N.
Klicken Sie im Dialogfeld Neue Datei unter der Kategorie Allgemein auf die Option Visual C#-Klasse, und klicken Sie dann auf Öffnen.

Im Editor öffnet sich eine neue Datei mit dem Skelett einer C#-Klasse. (Beachten Sie, dass Sie kein vollständiges Visual Studio-Projekt erstellen müssen, um einen Nutzen aus dem Code-Editor zu ziehen; Sie benötigen lediglich eine Codedatei.)

Öffnen Sie Visual Studio. Drücken Sie ESC, oder klicken Sie im Startfenster auf Ohne Code fortfahren, um die Entwicklungsumgebung zu öffnen.
Wählen Sie im Menü Datei auf der Menüleiste Neu>Datei aus, oder drücken sie STRG+N.
Klicken Sie im Dialogfeld Neue Datei unter der Kategorie Allgemein auf die Option Visual C#-Klasse, und klicken Sie dann auf Öffnen.

Im Editor öffnet sich eine neue Datei mit dem Skelett einer C#-Klasse. Sie müssen kein vollständiges Visual Studio-Projekt erstellen, um einige der Vorteile des Code-Editors zu nutzen. Sie benötigen lediglich eine Codedatei.

Verwenden von Codeausschnitten

Visual Studio stellt nützliche Codeausschnitte bereit, die Sie verwenden können, um häufig verwendete Codeblöcke schnell und einfach zu generieren. Die Codeausschnitte sind für verschiedene Programmiersprachen verfügbar, einschließlich C#, Visual Basic und C++.

Fügen Sie den C#-Ausschnitt void Main zu Ihrer Datei hinzu.

Platzieren Sie Ihren Cursor direkt oberhalb der letzten schließenden geschweiften Klammer } in der Datei, und geben Sie die Zeichen svm ein (dies steht für static void Main – machen Sie sich nicht allzu viele Sorgen, wenn Sie nicht wissen, was dies bedeutet).

Ein Popup-Dialogfeld mit Informationen zum Codeausschnitt svm wird angezeigt.
Drücken Sie zweimal auf die TAB-TASTE, um den Codeausschnitt einzufügen.

Daraufhin wir die Methodensignatur static void Main() zu der Datei hinzugefügt. Die Main()-Methode ist der Einstiegspunkt für C#-Anwendungen.

Die verfügbaren Codeausschnitte variieren je nach Programmiersprache. Sie können sich die für Ihre Sprache verfügbaren Codeausschnitte anzeigen lassen, indem Sie Bearbeiten>IntelliSense>Ausschnitt einfügen auswählen, oder indem Sie STRG+K, STRG+X drücken, und anschließend den Ordner für Ihre Sprache auswählen. Für C# sieht die Liste wie folgt aus:

Screenshot of an IntelliSense pop-up for a C# code snippet list.

Platzieren Sie den Cursor unmittelbar vor der letzten schließenden Klammer } in der Datei, und geben Sie svm ein. svm steht für static void Main. Machen Sie sich keine Sorgen, wenn Sie noch nicht wissen, was das bedeutet.

Ein Popup-Dialogfeld mit Informationen zum Codeausschnitt svm wird angezeigt.
Drücken Sie zweimal auf die TAB-TASTE, um den Codeausschnitt einzufügen.

Daraufhin wir der Datei die Methodensignatur static void Main() hinzugefügt. Die Main()-Methode ist der Einstiegspunkt für C#-Anwendungen.

Verfügbare Codeausschnitte variieren je nach Programmiersprache. Sie können sich die für Ihre Sprache verfügbaren Codeausschnitte anzeigen lassen, indem Sie Bearbeiten>IntelliSense>Ausschnitt einfügen auswählen oder STRG+K, STRG+X drücken und anschließend den Ordner für Ihre Programmiersprache auswählen. Für C# sieht die Codeausschnittliste folgendermaßen aus:

Screenshot of an IntelliSense pop-up for a C# code snippet list.

Die Liste enthält u.a. Ausschnitte zum Erstellen einer Klasse, eines Konstruktors, einer for-Schleife und einer if- oder switch-Anweisung.

Auskommentieren von Code

Durch die Symbolleiste – der Zeile mit Schaltflächen unter der Menüleiste in Visual Studio – können Sie Ihre Produktivität beim Codieren steigern. Sie können beispielsweise den IntelliSense-Beendigungsmodus umschalten (IntelliSense ist eine Codierungshilfe, die u.a. eine Liste von übereinstimmenden Methoden anzeigt), einen Zeileneinzug verkleinern oder vergrößern oder Code auskommentieren, der nicht kompiliert werden soll. In diesem Abschnitt wird Code auskommentiert.

Screenshot of the Editor toolbar in Visual Studio.

Fügen Sie den folgenden Code in den Methodentext Main() ein.

// _words is a string array that we'll sort alphabetically
string[] _words = {
    "the",
    "quick",
    "brown",
    "fox",
    "jumps"
};

string[] morewords = {
    "over",
    "the",
    "lazy",
    "dog"
};

IEnumerable<string> query = from word in _words
                            orderby word.Length
                            select word;

Die Variable morewords wird an dieser Stelle zwar nicht verwendet, allerdings sollte sie nicht vollständig gelöscht werden, weil sie unter Umständen später noch benötigt wird. Kommentieren Sie diese Zeilen stattdessen aus. Wählen Sie die komplette Definition von morewords bis zum abschließenden Semikolon aus, und klicken Sie anschließend in der Symbolleiste auf die Schaltfläche Ausgewählte Zeilen auskommentieren. Wenn Sie lieber die Tastatur verwenden möchten, drücken Sie STRG+K, STRG+C.

Die C#-Kommentarzeichen // werden am Anfang jeder ausgewählten Zeile hinzugefügt, um den Code auszukommentieren.

Mithilfe der Symbolleiste, also der Leiste mit Schaltflächen unterhalb der Menüleiste in Visual Studio, können Sie Ihre Produktivität beim Programmieren steigern. Beispielsweise können Sie den IntelliSense-Vervollständigungsmodus ein- und ausschalten, Zeileneinzüge vergrößern oder verkleinern oder Code auskommentieren, der nicht kompiliert werden soll.

Screenshot of the Text Editor toolbar in Visual Studio 2022.

Wir werden jetzt einigen Code auskommentieren.

Fügen Sie den folgenden Code in den Methodentext Main() ein.

// someWords is a string array.
string[] someWords = {
    "the",
    "quick",
    "brown",
    "fox",
    "jumps"
};

string[] moreWords = {
    "over",
    "the",
    "lazy",
    "dog"
};

// Alphabetically sort the words.
IEnumerable<string> query = from word in someWords
                            orderby word
                            select word;

Die Variable moreWords verwenden wir zwar nicht, aber sie soll auch nicht gelöscht werden, weil sie unter Umständen später noch benötigt wird. Stattdessen kommentieren wir diese Zeilen aus. Wählen Sie die komplette Definition von moreWords bis zum abschließenden Semikolon aus, und klicken Sie anschließend in der Symbolleiste auf die Schaltfläche Ausgewählte Zeilen auskommentieren. Wenn Sie lieber die Tastatur verwenden möchten, drücken Sie STRG+E, STRG+C.

Die C#-Kommentarzeichen // werden am Anfang jeder ausgewählten Zeile hinzugefügt, um den Code auszukommentieren.

Reduzieren von Codeblöcken

Der leere Konstruktor, der für Class1 generiert wurde, soll nicht angezeigt werden. Daher reduzieren wir ihn, um den Code übersichtlicher zu gestalten. Klicken Sie auf das kleine graue Feld mit dem Minuszeichen auf dem Rand neben der ersten Zeile des Konstruktors. Wenn Sie lieber mit der Tastatur arbeiten, platzieren Sie den Cursor an einer beliebigen Stelle im Konstruktorcode, und drücken Sie STRG+M, STRG+M.

Der Codeblock wird bis auf die erste Zeile reduziert, an die Auslassungspunkte angehängt werden (...). Klicken Sie nun auf dasselbe graue Feld, das diesmal mit einem Pluszeichen versehen ist, um den Codeblock erneut zu erweitern, oder drücken Sie zweimal STRG+M, STRG+M. Dieses Feature wird als Gliedern bezeichnet und ist besonders nützlich, wenn Sie lange Methoden oder ganze Klassen reduzieren möchten.

Der Codeblock wird bis auf die erste Zeile reduziert, an die Auslassungspunkte angehängt werden (...). Um den Codeblock wieder zu erweitern, klicken Sie auf dasselbe graue Feld, das diesmal mit einem Pluszeichen versehen ist, bzw. drücken Sie erneut STRG+M, STRG+M. Dieses Feature wird als Gliedern bezeichnet und ist besonders nützlich, wenn Sie lange Methoden oder ganze Klassen reduzieren möchten.

Anzeigen von Symboldefinitionen

Der Visual Studio-Editor erleichtert u.a. die Prüfung der Definition eines Typs oder einer Methode. Sie können z.B. zu der Datei navigieren, die die Definition enthält, indem Sie an einer beliebigen Stelle, an der auf das Symbol verwiesen wird, Gehe zu Definition auswählen oder F12 drücken. Sie können auch die Option Definition einsehen verwenden. Dies stellt eine schnellere Möglichkeit dar, bei der der Fokus weiterhin auf der Datei liegt. Im Folgenden wird die Definition von Typ string dargestellt.

Klicken Sie mit der rechten Maustaste auf eine beliebige Darstellung von string, und wählen Sie im Inhaltsmenü die Option Definition einsehen aus. Drücken Sie alternativ ALT+F12.

Daraufhin wird ein Popupfenster mit der Definition der String-Klasse angezeigt. Sie können in dem Popupfenster scrollen oder sogar die Definition eines anderen Typs des eingesehenen Codes einsehen.
Schließen Sie das eingesehene Definitionsfenster, indem Sie auf das kleine „x“ in der oberen rechten Ecke des Popupfensters klicken.

Der Visual Studio-Editor erleichtert das Überprüfen der Definition eines Typs, einer Methode oder einer Variablen. Beispielsweise können Sie zur Definition navigieren (unabhängig davon, in welcher Datei sie enthalten ist), indem Sie an einer beliebigen Stelle, an der auf ein Symbol verwiesen wird, Zur Definition wechseln auswählen oder F12 drücken. Eine noch schnellere Möglichkeit, bei der der Fokus auf dem bearbeiteten Code verbleibt, bietet die Option Definition einsehen.

Im Folgenden wird die Definition von Typ string dargestellt.

Klicken Sie mit der rechten Maustaste auf eine beliebige Darstellung von string, und wählen Sie im Inhaltsmenü die Option Definition einsehen aus. Drücken Sie alternativ ALT+F12.

Daraufhin wird ein Popupfenster mit der Definition der String-Klasse angezeigt. Sie können in dem Popupfenster scrollen oder sogar die Definition eines anderen Typs des eingesehenen Codes einsehen.
Schließen Sie das Fenster „Definition einsehen“, indem Sie auf das „x“ in der oberen rechten Ecke des Popupfensters klicken.

Verwenden von IntelliSense zum Vervollständigen von Wörtern

IntelliSense ist eine wichtige Ressource beim Codieren. Damit erhalten Sie Informationen zu verfügbaren Members eines Typs oder Parameterdetails für verschiedene Überladungen einer Methode. Sie können IntelliSense auch verwenden, um Wörter zu vervollständigen, nachdem genug Zeichen eingegeben wurden, um sie eindeutig zu machen. Fügen Sie eine einzige Codezeile hinzu, um die geordneten Zeichenfolgen im Konsolenfenster auszugeben. Dies ist der standardmäßige Ort für die Programmausgabe.

Beginnen Sie unter der Variable query mit dem Eingeben des folgenden Codes:
```
foreach (string str in qu
```
Dann zeigt IntelliSense Ihnen QuickInfo zum query-Symbol an.
Drücken Sie die TAB-TASTE, um den Rest des Worts query über die IntelliSense-Funktion zur Wortvervollständigung einzufügen.
Vervollständigen Sie den Codeblock, sodass dieser wie der folgende Code aussieht. Sie können das Verwenden von Codeausschnitten noch einmal üben, indem Sie cw eingeben und dann zweimal die TAB-TASTE drücken, um den Console.WriteLine-Code zu generieren.
```
foreach (string str in query)
{
   Console.WriteLine(str);
}
```

Fügen Sie eine einzige Codezeile hinzu, um die geordneten Zeichenfolgen im Konsolenfenster auszugeben. Dies ist der standardmäßige Ort für die Programmausgabe.

Beginnen Sie unter der Variable query mit dem Eingeben des folgenden Codes:
```
foreach (string str in qu
```
Anschließend wird ein IntelliSense-Popup mit Informationen zum query-Symbol angezeigt.
Drücken Sie die TAB-TASTE, um den Rest des Worts query über die IntelliSense-Wortvervollständigung einzufügen.
Vervollständigen Sie den Codeblock, sodass dieser wie der folgende Code aussieht. Sie können das Verwenden von Codeausschnitten weiter üben, indem Sie cw eingeben und dann zweimal die TAB-TASTE drücken, um die Console.WriteLine-Anweisung zu generieren.
```
foreach (string str in query)
{
   Console.WriteLine(str);
}
```

Refactoring eines Namens

Niemandem gelingt das Codieren schon beim ersten Versuch. Es ist also sehr wahrscheinlich, dass Sie irgendwann den Namen einer Variablen oder Methode ändern möchten. Testen Sie die Funktion Refactoring von Visual Studio, um die _words-Variable in words umzubenennen.

Platzieren Sie den Cursor über der Definition der _words-Variable, und klicken Sie im Kontextmenü (Rechtsklick) auf Umbenennen, oder drücken Sie STRG+R, STRG+R.

Daraufhin wird das Dialogfeld Umbenennen in der oberen rechten Ecke des Editors angezeigt.
Geben Sie den gewünschten Namen Wörter ein. Beachten Sie dabei, dass der Verweis auf words in der Abfrage ebenfalls automatisch umbenannt wird. Aktivieren Sie das Kontrollkästchen Kommentare einbeziehen im Dialogfeld Umbenennen, bevor Sie auf die EINGABETASTE drücken.
Drücken Sie die EINGABETASTE.

Beide Instanzen von words sowie der Verweis auf words im Codekommentar wurden umbenannt.

Platzieren Sie den Cursor auf der Definition der Variablen someWords, und klicken Sie im Rechtsklick- oder Kontextmenü auf Umbenennen, oder drücken Sie F2.

Daraufhin wird das Dialogfeld Umbenennen in der oberen rechten Ecke des Editors angezeigt.
Geben Sie den gewünschten Namen unsortedWords ein. Beachten Sie dabei, dass der Verweis auf unsortedWords in der query-Zuweisungsanweisung ebenfalls automatisch umbenannt wird. Aktivieren Sie das Kontrollkästchen Kommentare einbeziehen im Dialogfeld Umbenennen, bevor Sie auf die EINGABETASTE drücken.
Drücken Sie die EINGABETASTE, oder klicken Sie im Dialogfeld Umbenennen auf Anwenden.

Beide Instanzen von someWords in Ihrem Code sowie der Text someWords im Codekommentar wurden umbenannt.