Freigeben oder Wiederverwenden von Visual Studio-Projekteinstellungen

Zum Erstellen einer benutzerdefinierten Gruppe von Einstellungen, die Sie für andere Personen freigeben oder in mehreren Projekten wiederverwenden können, verwenden Sie den Eigenschaften-Manager , um ein Eigenschaftenblatt (eine .props Datei) zu erstellen, um die Einstellungen für jede Art von Projekt zu speichern, die Sie für andere Personen wiederverwenden oder freigeben möchten. Die Verwendung von Eigenschaftenblättern ist wesentlich weniger fehleranfällig als andere Methoden zum Erstellen von "globalen" Einstellungen.

Wichtig

Das Problem mit *.user Dateien

In früheren Versionen von Visual Studio wurden globale Eigenschaftenblätter verwendet, die eine .user Dateinamenerweiterung hatten und sich im \<userprofile>\AppData\Local\Microsoft\MSBuild\v4.0\ Ordner befinden.

Microsoft empfiehlt die Verwendung dieses Ansatzes nicht mehr. Diese Dateien legen Eigenschaften für Projektkonfigurationen auf Benutzerbasis pro Computer fest. Solche globalen Einstellungen können Builds beeinträchtigen, insbesondere wenn Sie mehr als eine Plattform auf Ihrem Buildcomputer verwenden. Wenn Sie z. B. über ein MFC-Projekt und Windows Phone-Projekt verfügen, sind die .user Eigenschaften für eines dieser Projekte ungültig. Wiederverwendbare Eigenschaftenblätter sind flexibler und stabiler.

Obwohl Visual Studio weiterhin Dateien installiert .user und an der Eigenschaftsvererbung teilnehmen, sind sie standardmäßig leer. Die bewährte Methode besteht darin, alle Verweise auf sie im Eigenschaften-Manager zu löschen, um sicherzustellen, dass Ihre Projekte unabhängig von den Einstellungen pro Benutzer und Computer funktionieren. Diese Vorgehensweise ist wichtig, um das richtige Verhalten in einer Quellcodeverwaltungsumgebung sicherzustellen.

Um den Eigenschaften-Manager anzuzeigen, wählen Sie in der Menüleiste je nach Ihren Einstellungen Anzeigen>Eigenschaften-Manager oder Anzeigen>Weitere Fenster>Eigenschaften-Manager.

Wenn Sie einen gemeinsamen, häufig verwendeten Satz von Eigenschaften auf mehrere Projekte anwenden möchten, verwenden Sie den Eigenschaften-Manager , um sie in einer wiederverwendbaren Eigenschaftenblattdatei zu erfassen, die standardmäßig über eine .props Dateinamenerweiterung verfügt. Sie können das Blatt (oder die Blätter) auf neue Projekte anwenden, sodass Sie diese Eigenschaften nicht von Grund auf neu festlegen müssen.

Screenshot des Kontextmenüs des Eigenschaften-Managers.

Unter jedem Konfigurationsknoten werden Knoten für jedes Eigenschaftenblatt angezeigt, das für diese Konfiguration gilt. Das System fügt Eigenschaftenblätter hinzu, die allgemeine Werte basierend auf optionen festlegen, die Sie beim Erstellen des Projekts im App-Assistenten auswählen. Klicken Sie mit der rechten Maustaste auf einen beliebigen Knoten, und wählen Sie "Eigenschaften" aus, um die Eigenschaften anzuzeigen, die für diesen Knoten gelten.

Alle Eigenschaftenblätter werden automatisch in das primäre Eigenschaftenblatt (ms.cpp.props) des Projekts importiert und in der Reihenfolge ausgewertet, in der sie im Eigenschaften-Manager angezeigt werden. Sie können sie verschieben, um die Reihenfolge der Auswertung zu ändern. Eigenschaftenblätter, die später ausgewertet werden, überschreiben die Werte in zuvor ausgewerteten Blättern.

Weitere Informationen zur Reihenfolge der Auswertung in der .vcxproj Datei, den .props Dateien .targets , Umgebungsvariablen und der Befehlszeile finden Sie unter Project-Eigenschaftsvererbung.

Wenn Sie auf Neues Projekteigenschaftenblatt hinzufügen klicken und dann beispielsweise das Eigenschaftenblatt „MyProps.props“ auswählen, wird das Dialogfeld „Eigenschaftenseiten“ geöffnet. Beachten Sie, dass es für das MyProps-Eigenschaftenblatt gilt. Alle Änderungen, die Sie vornehmen, werden in das Blatt und nicht in die Projektdatei (VCXPROJ) geschrieben.

Eigenschaften in einem Eigenschaftenblatt werden überschrieben, wenn dieselbe Eigenschaft direkt in der .vcxproj Datei festgelegt wird.

Sie können ein Eigenschaftenblatt so oft wie nötig importieren. Mehrere Projekte in einer Projektmappe können Einstellungen aus demselben Eigenschaftenblatt erben, und ein Projekt kann über mehrere Blätter verfügen. Eigenschaftenblätter selbst können Einstellungen von einem anderen Eigenschaftenblatt erben.

Sie können auch ein allgemeines Eigenschaftenblatt für mehrere Konfigurationen erstellen. Um ein Eigenschaftenblatt für jede Konfiguration zu erstellen, öffnen Sie das Kontextmenü für eine dieser Eigenschaften, wählen Sie "Vorhandenes Eigenschaftenblatt hinzufügen" aus, und fügen Sie dann die anderen Blätter hinzu. Wenn Sie jedoch ein gemeinsames Eigenschaftenblatt verwenden, gelten die Eigenschaften, die Sie festlegen, für alle Konfigurationen, für die das Blatt gilt. Die IDE zeigt nicht an, welche Projekte oder andere Eigenschaftenblätter von einem bestimmten Eigenschaftenblatt erben.

In großen Lösungen mit vielen Projekten kann es hilfreich sein, ein gemeinsames Eigenschaftenblatt für alle Projekte in der Projektmappe zu erstellen. Erstellen Sie das Eigenschaftenblatt wie gewohnt. Verwenden Sie Property Manager, um dieses Eigenschaftenblatt jedem Projekt in der Projektmappe hinzuzufügen. Bei Bedarf auf Projektebene können Sie ein weiteres Eigenschaftenblatt hinzufügen, um projektspezifische Werte festzulegen.

Wichtig

Eine .props Datei ist standardmäßig nicht an der Quellcodeverwaltung beteiligt, da sie nicht als Projektelement erstellt wird. Wenn Sie die Datei in die Quellcodeverwaltung aufnehmen möchten, können Sie sie manuell als Projektmappenelement hinzufügen.

So erstellen Sie ein Eigenschaftenblatt

  1. Wählen Sie in der Menüleiste Ansicht>Eigenschafts-Manager oder Ansicht>Weitere Fenster>Eigenschafts-Manager. Der Eigenschaften-Manager wird geöffnet.

  2. Wählen Sie das Element aus, auf das das Eigenschaftenblatt angewendet werden soll. Dieses Element kann eine bestimmte Konfiguration oder ein anderes Eigenschaftenblatt sein.

  3. Klicken Sie mit der rechten Maustaste auf das Element, und wählen Sie dann "Neues Project Eigenschaftenblatt hinzufügen" aus.

  4. Geben Sie im Dialogfeld " Neues Element hinzufügen " einen Namen und einen Speicherort für das Eigenschaftenblatt an. Visual Studio speichert die .props Datei am angegebenen Speicherort.

    Erweitern Sie die Elemente unter dem Projekt, um das Eigenschaftenblatt anzuzeigen.

  5. Öffnen Sie im Eigenschaften-Managerdas neue Eigenschaftenblatt, und legen Sie dann die Eigenschaften fest, die Sie einschließen möchten.

  • Last updated on