Codeausschnitte
Gilt für:Visual Studio
Visual Studio für Mac
Visual 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 eingebentryf
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.
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.