Eigenschaftenseiten (C++)

Mithilfe von Eigenschaftenseiten können Sie Einstellungen für Visual Studio-Projekte festlegen. Klicken Sie zum Öffnen des Dialogfelds Eigenschaftenseiten für ein Visual C++-Projekt im Menü Projekt auf Eigenschaften.

Sie können Projekteinstellungen so angeben, dass sie für alle Buildkonfigurationen gelten, oder Sie können unterschiedliche Projekteigenschaften für jede einzelne Buildkonfiguration angeben. Beispielsweise können Sie bestimmte Einstellungen für die Releasekonfiguration und andere Einstellungen für die Debugkonfiguration festlegen.

Nicht alle verfügbaren Seiten werden unbedingt im Dialogfeld Eigenschaftenseiten angezeigt. Welche Seiten angezeigt werden, hängt von den Dateitypen im Projekt ab. Wenn z. B. das Projekt keine IDL-Datei enthält, wird die IDL-Eigenschaftenseite nicht angezeigt.

Weitere Informationen finden Sie unter Gewusst wie: Festlegen von Projekteigenschaften mit Eigenschaftenseiten.

Standardeigenschaften im Vergleich zuGeänderte Eigenschaften

Wenn Sie das Dialogfeld Neues Projekt zum Erstellen eines Visual C++-Projekts verwenden, verwendet Visual Studio die jeweilige Projektvorlage, um die Projekteigenschaften zu initialisieren. Daher können die Eigenschaftswerte in der Vorlage als Standardwerte für diesen Projekttyp angesehen werden. In anderen Projekttypen können Eigenschaften über verschiedene Standardwerte verfügen.

Ein Wert für die Projekteigenschaften wird in Fettschrift angezeigt, wenn er geändert wird. Eine Projekteigenschaft kann aus folgenden Gründen geändert werden:

  • Der Anwendungs-Assistent ändert die Eigenschaft, da sie einen anderen Eigenschaftswert als den in der Projektvorlage angegebenen erfordert.

  • Geben Sie einen anderen Eigenschaftswert ins Dialogfeld Neues Projekt ein.

  • Sie geben einen anderen Eigenschaftswert auf einer Projekteigenschaftenseite an.

Tipp

Um die letzte Gruppe von Eigenschaftswerten anzuzeigen, die MSBuild verwendet, um das Projekt zu erstellen, überprüfen Sie die Präprozessorausgabedatei, die Sie mit dieser Befehlszeile generieren können: MSBuild /preprocess:preprocessor_output_filenameopt project_filenameopt.

Zurücksetzen von Eigenschaften

Wenn Sie das Dialogfeld Eigenschaftenseiten für ein Projekt anzeigen und der Projektknoten im Projektmappen-Explorer ausgewählt wird, können Sie für zahlreiche Eigenschaften Vom übergeordneten Projekt erben oder Projektstandard auswählen oder den Wert anderweitig ändern.

Wenn Sie das Dialogfeld Eigenschaftenseiten für ein Projekt anzeigen und eine Datei im Projektmappen-Explorer ausgewählt wird, können Sie für zahlreiche Eigenschaften Vom übergeordneten Projekt erben oder Projektstandard auswählen oder den Wert anderweitig ändern. Wenn das Projekt jedoch viele Dateien enthält, deren Eigenschaftswerte von den Projektstandardwerten abweichen, dauert es länger, das Projekt zu erstellen.

Tipp

Um das Dialogfeld Eigenschaftenseiten zu aktualisieren, sodass die aktuelle Auswahl angezeigt wird, klicken Sie auf Übernehmen.

Die meisten Projektstandardwerte sind Standardwerte des Systems ( der Plattform). Einige Projektstandardeinstellungen werden von den Stylesheets abgeleitet, die bei der Aktualisierung von Eigenschaften im Bereich Projektstandards der Projektkonfigurationseigenschaftenseite Allgemein für das Projekt übernommen werden. Weitere Informationen finden Sie unter Eigenschaftenseite "Allgemein" (Projekt).

Angeben benutzerdefinierter Werte

Sie müssen den Wert für bestimmte Eigenschaften definieren. Ein benutzerdefinierter Wert kann ein oder mehrere alphanumerische Zeichen oder Projekt-Datei-Makronamen enthalten. Einige dieser Eigenschaften können nur einen benutzerdefinierten Wert annehmen, aber andere können eine durch Semikolons getrennte Liste von mehreren Werten annehmen.

Um einen benutzerdefinierten Wert für eine Eigenschaft oder eine Liste anzugeben, falls die Eigenschaft mehrere benutzerdefinierte Werte übernehmen kann, führen Sie in der Spalte rechts neben dem Eigenschaftennamen eine der folgenden Aktionen aus:

  • Geben Sie den Wert oder die Werteliste ein.

  • Klicken Sie auf den Dropdownpfeil. Wenn Bearbeiten verfügbar ist, klicken Sie darauf, und geben Sie dann im Textfeld den Wert oder die Liste von Werten ein. Eine alternative Möglichkeit, eine Liste anzugeben, ist die Eingabe jedes Werts in einer separaten Zeile im Textfeld. Auf der Eigenschaftenseite werden die Werte als durch Semikolons getrennte Liste angezeigt.

    Klicken Sie zum Einfügen eines Projektdateimakros als Wert auf Makros, und führen Sie dann einen Doppelklick auf den Makronamen aus.

  • Klicken Sie auf den Dropdownpfeil. Wenn Durchsuchen verfügbar ist, klicken Sie darauf, und wählen Sie dann einen oder mehrere Werte aus.

Für eine Eigenschaft mit mehreren Werten ist die Option Vom übergeordneten Projekt erben oder Projektstandard verfügbar, wenn Sie auf den Dropdownpfeil in der Spalte rechts neben dem Eigenschaftennamen und dann auf Bearbeiten klicken. Diese Option ist standardmäßig ausgewählt.

Beachten Sie, dass eine Eigenschaftenseite nur die Einstellungen auf dem aktuellen Stand für eine mehrwertige Eigenschaft anzeigt, die von einer anderen Ebene geerbt wird. Wenn z. B. eine Datei im Projektmappen-Explorer ausgewählt ist und Sie die Eigenschaft C/C++-Eigenschaft Präprozessordefinitionen auswählen, werden Definitionen auf Dateiebene angezeigt, geerbte Definitionen auf Projektebene dagegen nicht. Um Werte der aktuellen Ebene und vererbte Werte anzuzeigen, klicken Sie auf den Dropdownpfeil in der Spalte rechts neben dem Eigenschaftennamen und klicken Sie dann auf Bearbeiten. Wenn Sie das Visual C++-Projektmodell verwenden, gilt dieses Verhalten auch für die datei- und projektspezifischen Objekte. Das heißt, wenn Sie die Werte einer Eigenschaft auf Dateiebene abfragen, rufen Sie die Werte für die gleiche Eigenschaft nicht auf Projektebene ab. Sie müssen die Werte der Eigenschaften auf Projektebene explizit abrufen. Darüber hinaus können einige geerbte Werte einer Eigenschaft aus einem Stylesheet stammen, auf das nicht programmgesteuert zugegriffen werden kann.

Siehe auch

Aufgaben

Gewusst wie: Erstellen und Entfernen von Projektabhängigkeiten

Gewusst wie: Erstellen und Bearbeiten von Konfigurationen

Weitere Ressourcen

Windows Installer-Bereitstellungsaufgaben

Änderungsprotokoll

Datum

Versionsgeschichte

Grund

Juli 2010

Abschnitt "Standardeigenschaften im Vergleich zu geänderten Eigenschaften" überarbeitet.

Kundenfeedback.

Juli 2010

Neuer Abschnitt "Angeben benutzerdefinierter Werte" überarbeitet.

Informationsergänzung.