Codeausschnitte

Gilt für:yesVisual Studio noVisual Studio für MacnoVisual 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.

Screenshot des Dialogfelds

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:

  1. Positionieren Sie den Cursor im Codefenster an der Stelle, an der Sie den Codeausschnitt hinzufügen möchten.

  2. Wählen Sie im Kontextmenü mit der rechten Maustaste Ausschnitt einfügen aus.

  3. Wählen Sie Visual C# aus, geben Sie dann eintryf, und drücken Sie dann die TAB-TASTE. (Oder Sie können die TAB-TASTE zweimal eingeben tryf und 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.

Screenshot des Codeausschnittmenüs für Definieren einer Eigenschaft.

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.

Weitere Informationen