Eigenschaften- und Feldumgestaltungen

Visual Studio bietet mehrere Umgestaltungen zum Arbeiten mit Eigenschaften und Feldern. Sie können über das Menü "Schnelle Aktionen und Umgestaltungen " (STRG+) auf diese Umgestaltungen zugreifen.

Feld kapsulieren

Gilt für: C#, Visual Basic

Diese Umgestaltung wandelt ein Feld in eine Eigenschaft um und aktualisiert alle Verwendungen dieses Felds, um die neu erstellte Eigenschaft zu verwenden. Auf diese Weise können Sie den Zugriff steuern, indem Sie Validierungscode in der Eigenschaft schreiben.

  1. Markieren oder platzieren Sie den Textcursor in den Namen des Felds, das gekapselt werden soll:

    • C#:

      Screenshot des hervorgehobenen Codes – C#.

    • Visual Basic:

      Screenshot des hervorgehobenen Codes - Visual Basic.

  2. Führen Sie als Nächstes eine der folgenden Aktionen aus:

    • Tastatur
      • Drücken Sie STRG+R, dann STRG+E. (Die Tastenkombination kann je nach ausgewähltem Profil unterschiedlich sein.)
      • Drücken Sie STRG+. Um das Menü "Schnelle Aktionen" und "Umgestaltungen" auszulösen , und wählen Sie im Popupfenster des Vorschaufensters entweder den Feldeintrag "Kapseln " aus.
    • Maus
      • Wählen Sie "Umgestalten >> bearbeiten" aus, um das Feld zu kapseln.
      • Klicken Sie mit der rechten Maustaste auf den Code, wählen Sie das Menü "Schnelle Aktionen und Umgestaltungen" aus , und wählen Sie im Popupfenster des Vorschaufensters entweder den Feldeintrag "Kapseln " aus.
    Auswahl Beschreibung
    Kapseln des Felds (und Verwenden der Eigenschaft) Kapselt das Feld mit einer Eigenschaft und aktualisiert alle Verwendungen des Felds, um die generierte Eigenschaft zu verwenden.
    Kapselung des Felds (aber weiterhin Verwenden des Felds) Kapselt das Feld mit einer Eigenschaft, lässt jedoch alle Verwendungen des Felds unberührt.

    Die Eigenschaft wird erstellt, und Verweise auf das Feld werden aktualisiert, falls ausgewählt.

    Tipp

    Verwenden Sie den Link "Vorschauänderungen " im Popupfenster , um zu sehen, was das Ergebnis vor dem Commit für das Ergebnis ist.

    • C#:

      Screenshot des Kapselungseigenschaftenergebnisses - C#.

    • Visual Basic:

      Screenshot des Kapselungseigenschaftenergebnisses - Visual Basic.

Konvertieren zwischen automatischen und vollständigen Eigenschaften

Gilt für: C#

Diese Umgestaltung konvertiert zwischen einer automatisch implementierten Eigenschaft und einer vollständigen Eigenschaft, die nützlich ist, wenn sich die Logik der Eigenschaft geändert hat und Sie ein Sicherungsfeld benötigen.

  1. Platzieren Sie den Cursor auf den Eigenschaftennamen.

  2. Drücken Sie STRG+., um das Menü Schnellaktionen und Refactorings aufzurufen.

  3. Wählen Sie eine der folgenden beiden Optionen aus:

    Wählen Sie "In vollständige Eigenschaft konvertieren" aus.

    Screenshot der Automatischen Eigenschaft in vollständige Eigenschaft konvertieren.

    Wählen Sie "Auto-Eigenschaft verwenden" aus.

    Screenshot der Vollständigen Eigenschaft in auto-Eigenschaft konvertieren.

Konvertierung zwischen der Get-Methode und der Konvertierungseigenschaft

Gilt für: C#, Visual Basic

In diesem Abschnitt werden bidirektionale Konvertierungen zwischen Get-Methoden und Eigenschaften behandelt.

Convert Get-Methode in Eigenschaft

Diese Umgestaltung konvertiert eine Get-Methode in eine Eigenschaft (und optional die Set-Methode), die nützlich ist, wenn eine Get-Methode keine Logik enthält.

  1. Platzieren Sie den Cursor im Get-Methodennamen.

  2. Führen Sie als Nächstes eine der folgenden Aktionen aus:

    • Tastatur
      • Drücken Sie STRG+. Um das Menü "Schnelle Aktionen und Umgestaltungen" auszulösen , und wählen Sie "Ersetzen"-Methode mit Eigenschaft aus dem Popupfenster "Vorschau" aus.
    • Maus
      • Klicken Sie mit der rechten Maustaste auf den Code, wählen Sie das Menü "Schnelle Aktionen und Umgestaltungen" aus , und wählen Sie "Ersetzen"-Methode mit Eigenschaft im Popupfenster "Vorschau" aus.
  3. (Optional) Wenn Sie über eine Set-Methode verfügen, können Sie ihre Set-Methode zu diesem Zeitpunkt auch konvertieren, indem Sie "Replace Get"-Methode und "Set"-Methode mit "Eigenschaft" auswählen.

  4. Wenn Sie mit der Änderung in der Codevorschau zufrieden sind, drücken Sie die EINGABETASTE , oder klicken Sie im Menü auf die Korrektur, und die Änderungen werden übernommen.

Beispiel:

private int MyValue;

// Before
public int GetMyValue()
{
    return MyValue;
}

// Replace 'GetMyValue' with property

// After
public int MyValue
{
    get { return MyValue; }
}

Convert-Eigenschaft in Get-Methode

Durch diese Umgestaltung wird eine Eigenschaft in eine Get-Methode konvertiert, die nützlich ist, wenn eine Eigenschaft mehr als sofort festlegen und einen Wert abrufen muss.

  1. Platzieren Sie den Cursor im Get-Methodennamen.

  2. Führen Sie als Nächstes eine der folgenden Aktionen aus:

    • Tastatur
      • Drücken Sie STRG+. Um das Menü "Schnelle Aktionen und Umgestaltungen" auszulösen , und wählen Sie "Eigenschaft ersetzen" aus dem Popupfenster "Vorschau" aus.
    • Maus
      • Klicken Sie mit der rechten Maustaste auf den Code, wählen Sie das Menü "Schnelle Aktionen und Umgestaltungen" aus , und wählen Sie " Eigenschaft ersetzen" aus dem Popupfenster "Vorschau" aus.
  3. Wenn Sie mit der Änderung in der Codevorschau zufrieden sind, drücken Sie die EINGABETASTE , oder klicken Sie im Menü auf die Korrektur, und die Änderungen werden übernommen.