Eigenschaftenseiten (C++)

Artikel
09/02/2008

Aktualisiert: November 2007

Eine Projekteigenschaftenseite ist ein Element der Visual Studio-Benutzeroberfläche, über das Sie Projekteinstellungen für Projekte angeben und übernehmen können.

Sie greifen auf Eigenschaftenseiten zu, indem Sie ein Projekt auswählen und im Kontextmenü oder im Menü Projekt auf Eigenschaften klicken. Wenn Sie Werte im Dialogfeld Eigenschaftenseiten angeben, werden sie im Projektmappen-Explorer für das oder die ausgewählten Projekte übernommen.

Sie können Projekteinstellungen für alle Buildkonfigurationen angeben und übernehmen oder aber separate Projekteigenschaften für jede einzelne Buildkonfiguration festlegen. Beispielsweise können Sie Einstellungen für die Releasekonfiguration festlegen, die nicht für die Debugkonfiguration gelten.

Da Eigenschaftenseiten dynamisch konzipiert sind, richten sich die angezeigten Seiten nach den im Projekt enthaltenen Dateitypen. Falls im Projekt beispielsweise keine IDL-Datei enthalten ist, wird die Seite mit IDL-Eigenschaften nicht im Dialogfeld Eigenschaftenseiten angezeigt.

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

Standardwert oder geänderte Eigenschaften?

Einige Eigenschaftenwerte werden in Fettdruck angezeigt. Dies deutet darauf hin, dass der Wert geändert wurde. Die Standardeinstellung, die eine Eigenschaft auf Projektebene hat (wenn der Projektknoten im Projektmappen-Explorer ausgewählt ist) ist generell der Standardwert dieser Eigenschaft für das jeweilige Tool. In einem Win32-Projekt werden Sie auf der Eigenschaftenseite Codegenerierung des Compilers z. B. feststellen, dass die Eigenschaft Stringpooling aktivieren zunächst automatisch auf Nein gesetzt ist (sie ist nicht fett dargestellt). Dies bedeutet, dass Nein der Standardeinstellung des Projekts entspricht. Wenn Sie in der Befehlszeile CL.exe ausführen müssen, ist /GF erst wirksam, nachdem Sie diesen Schalter festgelegt haben.

Wird eine Eigenschaft von Ihnen oder dem Anwendungs-Assistenten geändert, ist der Wert fett dargestellt. Auf derselben Eigenschaftenseite Codegenerierung sehen Sie auch, dass /RTC1 für die Eigenschaft Vollständige Laufzeitüberprüfungen wirksam ist. /RTC1 ist in der Befehlszeile standardmäßig nicht aktiviert. Die Standardeinstellung dieser Eigenschaft wurde in diesem Fall vom Anwendungs-Assistenten geändert.

Eine Teilmenge der Projektstandards wird verfügbar gemacht und kann vom Benutzer geändert werden. Weitere Informationen finden Sie im Bereich Projektstandards unter der Eigenschaftenseite "Allgemein" (Projekt).

Zurücksetzen von Eigenschaften

Wenn Sie das Dialogfeld Eigenschaftenseiten eines Projekts anzeigen und der Projektknoten im Projektmappen-Explorer ausgewählt ist, haben Sie die Möglichkeit, für jede Eigenschaft <Vom Projekt übernehmen> auszuwählen.

Klicken Sie auf Übernehmen, um sicherzustellen, dass das Dialogfeld Eigenschaftenseiten mit den letzten Auswahloptionen aktualisiert wird, nachdem Sie eine Eigenschaft auf den Projektstandard zurückgesetzt haben.

Wenn Sie das Dialogfeld Eigenschaftenseiten eines Projekts anzeigen lassen und im Projektmappen-Explorer eine Datei ausgewählt ist, deutet ein fett formatierter Eigenschaftenwert darauf hin, dass der Wert der Eigenschaft auf Dateiebene geändert wurde. Dementsprechend haben Sie für jede Eigenschaft die Möglichkeit, <Vom Projekt übernehmen> auszuwählen. Falls viele Dateien über geänderte Eigenschaften verfügen, verlängert sich die Buildzeit für das Projekt.

In den meisten Fällen entsprechen die Projektstandardeinstellungen denen des Systems (der Plattform). Einige Projektstandardeinstellungen werden von den Stylesheets abgeleitet, die bei der Aktualisierung von Eigenschaften im Bereich Projektstandards der allgemeinen Projektkonfigurationsseite übernommen werden (siehe Eigenschaftenseite "Allgemein" (Projekt)).

Eingeben benutzerdefinierter Werte

Bei anderen Eigenschaften wird vorausgesetzt, dass Sie Werte für die Eigenschaft festlegen. Einige dieser Eigenschaften enthalten einen oder mehrere Werte (Mehrfacheigenschaften) und andere enthalten nur einen Wert (Einzeleigenschaften).

Sie haben die Möglichkeit, direkt in die rechte Spalte der Eigenschaftenseite zu schreiben. Trennen Sie mehrere Werte durch ein Semikolon voneinander. Verwenden Sie nur alphabetische und numerische Zeichen für diese Eigenschaften. Diese Werte werden keiner Fehlerüberprüfung unterzogen.

Sie können aus der Dropdownliste (für Einzeleigenschaften) auch <Bearbeiten...> auswählen oder (für eine markierte Mehrfacheigenschaft) auf die Schaltfläche mit dem Auslassungszeichen klicken. Dadurch wird ein Dialogfeld geöffnet, in dem Sie einen oder mehrere Werte für die Eigenschaft eingeben können. Der Titel des Dialogfelds entspricht den Namen der bearbeiteten Eigenschaft. Für Mehrfacheigenschaften geben Sie einen Wert pro Zeile ein, und fügen nach jedem Wert ein Wagenrücklaufzeichen ein.

Bearbeitungsfelder für Mehrfacheigenschaften verfügen über ein Kontrollkästchen mit der Beschriftung Vom Projekt geerbt (bei einer Datei) oder Vom Projektstandard geerbt (auf Projektebene). Dieses Kontrollkästchen ist standardmäßig aktiviert. Die Eigenschaft kann also, wenn eine Datei ausgewählt ist, Werte vom Projekt, oder wenn das Projekt im Projektmappen-Explorer ausgewählt ist, Werte von den Projektstandards erben.

Beachten Sie, dass die für eine Mehrfacheigenschaft im Dialogfeld Eigenschaftenseiten angezeigten Werte nur die Eigenschafteneinstellungen auf der aktuellen Ebene wiedergeben. Wenn eine Datei beispielsweise im Projektmappen-Explorer markiert ist und Sie die C/C++-Eigenschaft Präprozessordefinitionen auswählen, werden auf der Eigenschaftenseite keine Präprozessordefinitionen auf Projektebene angezeigt. Wenn Sie jedoch das Bearbeitungsfeld für die Mehrfacheigenschaft öffnen, können Sie alle geerbten Werte für die Eigenschaft sehen.

Wenn Sie das Visual C++-Projektmodell verwenden, sollten Sie sicherstellen, dass dieses Verhalten auch für die datei- und projektspezifischen Objekte gilt. Wenn Sie also die Werte für eine Eigenschaft auf Dateiebene abfragen, sind die Werte für dieselbe Eigenschaft auf Projektebene nicht verfügbar; die Werte der Eigenschaft müssen daher explizit auf Projektebene abgefragt werden. Einige der geerbten Eigenschaftenwerte stammen aus einem Stylesheet, auf das in dieser Version über das Programm nicht zugegriffen werden kann.

Die Makros $(Inherit) und $(NoInherit)

Beachten Sie, dass für Eigenschaften, für die Sie benutzerdefinierte Werte festlegen, die folgenden beiden Makros verfügbar sind:

$(Inherit)
$(NoInherit)

Das Deaktivieren des Kontrollkästchens (z. B. Vom Projektstandard geerbt) ist identisch mit dem Festlegen von $(NoInherit); allerdings ist die Verwendung des Kontrollkästchens einfacher. Auch wenn Sie $(NoInherit) festlegen, kann es sein, dass Sie trotzdem eigene Werte definieren möchten.

Wenn Sie eines dieser Makros im Bearbeitungsfeld verwenden, wird die Einstellung des Kontrollkästchens unabhängig von der Einstellung für das Kontrollkästchen Vom Projekt geerbt (bzw. Vom Projektstandard geerbt) ignoriert.

Wenn Sie $(NoInherit) für eine Eigenschaft verwenden, sollten Sie darauf achten, ob sich einer der Projektstandards auf die Eigenschaft auswirkt. Falls ja, kann es passieren, dass ein festgelegter Projektstandard unbeabsichtigt überschrieben wurde.