Teilen über


/headerName (Erstellen einer Kopfzeileneinheit aus der angegebenen Kopfzeile)

Erstellen Sie die angegebene Headerdatei in einer Headereinheit (.ifc Datei).

Syntax

/headerName:quote header-filename
/headerName:angle header-filename

Argumente

header-filename
Der Name einer Headerdatei, die der Compiler in eine Headereinheit (.ifc Datei) kompilieren soll.

Hinweise

Die /headerName:quote Optionen und /headerName:angle Compileroptionen stehen ab Visual Studio 2019, Version 16.10, zur Verfügung.

Für die /headerName Compileroptionen in allen ihren Formen ist die /std:c++20 oder die spätere Compileroption (z /std:c++latest. B. ) erforderlich.
Wenn Sie eine /headerName Option angeben, müssen Sie auch angeben /exportHeader.

  • /headerName:quoteheader-filename Sucht anhand der gleichen Regeln wie #include "header-filename" eine Kopfzeileneinheit (.ifc Datei) nach und erstellt sie.
  • /headerName:angleheader-filename Sucht anhand der gleichen Regeln wie #include <header-filename> eine Kopfzeileneinheit (.ifc Datei) nach und erstellt sie.

Weitere Informationen zu den Pfadsuchregeln für eingeschlossene Dateien in Anführungszeichen oder Winkelklammern finden Sie in #include der Direktive.

Beispiele

Bei einem Projekt, das auf eine von ihm definierte m.hHeaderdatei verweist, sieht die Compileroption zum Kompilieren in einer Kopfzeileneinheit ähnlich wie in diesem Beispiel aus:

cl /std:c++latest /exportHeader /headerName:quote m.h /Fom.h.obj

Die /headerName:quote Optionen /headerName:angle funktionieren wie eine Kennzeichnung und benötigen kein Argument. Die folgenden Beispiele sind gültig:

cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm
cl /std:c++latest /exportHeader /headerName:quote /MP /Fo.\ my-utilities.h a/b/my-core.h

Sie können mehrere /headerName Optionen in derselben Befehlszeile angeben. Jedes Argument nach der Verarbeitung einer /headerName Option mit den angegebenen Include-Datei-Nachschlageregeln für Anführungszeichen oder Winkelklammern bis zur nächsten /headerName Option. Im folgenden Beispiel werden alle Kopfzeilen wie die vorherigen beiden Befehlszeilenbeispiele auf die gleiche Weise wie zuvor verarbeitet. Die Kopfzeilen werden mithilfe der angewendeten Nachschlageregeln wie folgt nachschlagen: #include <vector>, , #include <iostream>, , #include <algorithm>, #include "my-utilties.h"und #include "a/b/my-core.h":

cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm /headerName:quote my-utilities.h a/b/my-core.h

So legen Sie diese Compileroption in der Visual Studio-Entwicklungsumgebung fest

Hinweis

Normalerweise sollten Sie diese Option in der Visual Studio-Entwicklungsumgebung nicht festlegen. Sie wird vom Buildsystem festgelegt.

  1. Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Weitere Informationen erhalten Sie unter Set C++ compiler and build properties in Visual Studio (Festlegen der Compiler- und Buildeigenschaften (C++) in Visual Studio).

  2. Legen Sie die Dropdownliste "Konfiguration " auf " Alle Konfigurationen" fest. Wählen Sie in der Dropdownliste Plattform die Option Alle Plattformen aus.

  3. Klicken Sie auf der Eigenschaftenseite auf Konfigurationseigenschaften>C/C++>Befehlszeile.

  4. Ändern Sie die Eigenschaft "Zusätzliche Optionen ", um die /headerName:quote Optionen hinzuzufügen, /headerName:angle und die Headerdateinamen, auf die die Optionen angewendet werden. Wählen Sie dann "OK" aus, oder "Übernehmen", um Ihre Änderungen zu speichern.

Weitere Informationen

/exportHeader (Erstellen von Headereinheiten)
/headerUnit (Verwenden der Headereinheit IFC)
/reference (Verwenden des benannten Moduls IFC)
/translateInclude (Übersetzen von include-Anweisungen in import-Anweisungen)