Codeausschnitte
Gilt für:
Visual Studio 
Visual Studio für MacVisual Studio Code
Codeausschnitte sind kleine Blöcke wiederverwendbaren Codes, die Sie einer Codedatei mithilfe des Kontextmenübefehls mit der rechten Maustaste oder einer Kombination von Hotkeys hinzufügen können. Codeausschnitte enthalten in der Regel häufig verwendete Codeblöcke wie try-finally oder if-else Blöcke, aber Sie können sie auch verwenden, um ganze Klassen oder Methoden hinzuzufügen.
Hinweis
Dieser Artikel gilt für Visual Studio unter Windows. Informationen zu Visual Studio für Mac finden Sie unter Codeausschnitte (Visual Studio für Mac).
Codeausschnitte sind für viele Sprachen verfügbar, einschließlich C#, C++ und Visual Basic, um nur einige zu nennen.
Um alle verfügbaren Codeausschnitte für eine Sprache anzuzeigen, wählen Sie in der Menüleiste Extras>Codeausschnitt-Manager aus (oder drücken Sie STRG+K, STRG+B), und wählen Sie dann im Dropdownmenü oben im Dialogfeld die gewünschte Sprache aus.
In Visual Studio gibt es verschiedene Möglichkeiten, wie Sie einer Codedatei einen Codeausschnitt hinzufügen können:
Klicken Sie in der Menüleiste auf Bearbeiten>IntelliSense>Ausschnitt einfügen.
Klicken Sie im Kontextmenü (Rechtsklick) im Code-Editor auf Ausschnitt>Ausschnitt einfügen.
Drücken Sie STRG+K und STRG+X.
Erweiterungsausschnitte und umschließende Ausschnitte
Es gibt zwei Arten von Codeausschnitten, die Sie Ihrem Code hinzufügen können.
| Codeausschnitttyp | Wie diese verwendet wird |
|---|---|
| Expansion | An einer angegebenen Einfügemarke hinzugefügt und ersetzt möglicherweise eine Ausschnittverknüpfung. |
| surround-with | Um einen ausgewählten Codeblock hinzugefügt (nur für C# und C++ verfügbar) |
Im folgenden Beispiel eines Erweiterungsausschnitts in C# fügt die Verknüpfung tryf einen Try-finally-Block hinzu:
try
{
}
finally
{
}
So fügen Sie diesen Erweiterungsausschnitt hinzu:
Positionieren Sie den Cursor im Codefenster an der Stelle, an der Sie den Codeausschnitt hinzufügen möchten.
Wählen Sie im Kontextmenü mit der rechten Maustaste Ausschnitt einfügen aus.
Wählen Sie Visual C# aus, geben Sie dann ein
tryf, und drücken Sie dann die TAB-TASTE. (Oder Sie können die TAB-TASTE zweimal eingebentryfund drücken.)
Im folgenden Beispiel eines Surround-With-Ausschnitts in C++ kann die Verknüpfung if entweder als Einfügeausschnitt oder als Surround-With-Codeausschnitt verwendet werden. Wenn Sie eine Codezeile aktivieren (z.B. return FALSE;) und dann auf Umschließen mit>if klicken, wird der Ausschnitt um folgende Zeile erweitert:
if (true)
{
return FALSE;
}
Ersatzparameter für Ausschnitte
Codeausschnitte können Ersetzungsparameter enthalten, bei denen es sich um Platzhalter handelt, die Sie ersetzen müssen, um dem von Ihnen geschriebenen Code zu entsprechen. Im vorherigen Beispiel true ist ein Ersetzungsparameter, den Sie durch die entsprechende Bedingung ersetzen würden. Diese Ersetzung wird für jede Instanz des Ersatzparameters im Ausschnitt wiederholt.
In Visual Basic gibt es z.B. einen Codeausschnitt, der eine Eigenschaft einfügt. Wählen Sie zum Einfügen des Codeausschnitts im Kontextmenü in einer Visual Basic-Codedatei die Option Codeausschnitt>einfügen aus. Wählen Sie dann Codemustereigenschaften>, Prozeduren, Ereignisse>Eigenschaft definieren aus.
Der folgende Code wird eingefügt:
Private newPropertyValue As String
Public Property NewProperty() As String
Get
Return newPropertyValue
End Get
Set(ByVal value As String)
newPropertyValue = value
End Set
End Property
Wenn Sie newPropertyValue in m_property ändern, wird jede Instanz von newPropertyValue geändert. Wenn Sie String in der Eigenschaftendeklaration in Int ändern, wird der Wert in der set-Methode ebenfalls in Int geändert.
Nächste Schritte
Informationen zum Erstellen eigener Codeausschnitte finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Codeausschnitts.