Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Instruerar kompilatorn att skapa de rubrikenheter som anges av indataargumenten. Kompilatorn genererar rubrikenheter som IFC-filer (.ifc).
Syntax
/exportHeader /headerName:angleheader-name
/exportHeader /headerName:quoteheader-name
/exportHeaderfull path to header file
Arguments
Argumentet till /exportHeader är ett /headerName kommandoradsalternativ som anger namnet, header-name, på huvudfilen som ska exporteras.
Anmärkningar
/exportHeader är tillgängligt från och med Visual Studio 2019 version 16.10.
Kompilatoralternativet /exportHeader kräver att du aktiverar kompilatoralternativet /std:c++20 eller senare (till exempel /std:c++latest).
Ett /exportHeader kompilatoralternativ kan ange så många huvudnamnsargument som krävs för bygget. Du behöver inte ange dem separat.
Kompilatorn aktiverar implicit den nya förprocessorn när det här alternativet används. Det vill: /Zc:preprocessor läggs till på kommandoraden av kompilatorn om någon form av /exportHeader används på kommandoraden. Om du vill avregistrera dig från implicit /Zc:preprocessoranvänder du: /Zc:preprocessor-
Som standard skapar kompilatorn inte en objektfil när en rubrikenhet kompileras. Om du vill skapa en objektfil anger du kompileringsalternativet /Fo . Mer information finns i /Fo (Objektfilnamn).
Det kan vara bra att använda det kompletterande alternativet /showResolvedHeader. Alternativet /showResolvedHeader skriver ut en absolut sökväg till filen som header-name argumentet löser.
/exportHeader kan hantera flera indata samtidigt, även under /MP. Vi rekommenderar att du använder /ifcOutput <directory> för att skapa en separat .ifc fil för varje kompilering.
Examples
Så här skapar du en rubrikenhet som <vector> kan se ut så här:
cl . . . /std:c++latest /exportHeader /headerName:angle vector
Skapa ett lokalt projekthuvud som "utils/util.h" kan se ut så här:
cl . . . /std:c++latest /exportHeader /headerName:quote util/util.h
Ange det här kompilatoralternativet i Visual Studio-utvecklingsmiljön
Du bör normalt inte ange det här alternativet i Visual Studio-utvecklingsmiljön om du inte använder ett annat tillägg för dina huvudfiler. Som standard tillämpar byggsystemet det här alternativet på kompilerade filer som har ett .h tillägg eller inget tillägg.
Om du vill använda
/exportHeaderalternativet för en fil explicit i IDE väljer du filen i Solution Explorer. Högerklicka för att öppna snabbmenyn och välj Egenskaper för att öppna dialogrutan Egenskapssidor.Ange listrutan Konfiguration till Alla konfigurationer. Ange listrutan Plattform till Alla plattformar.
Öppna egenskapssidan Konfigurationsegenskaper>C/C++>Avancerat .
Använd listrutekontrollen för att ändra egenskapen Kompilera som till Kompilera som C++ Rubrikenhet (/exportHeader). Välj OK eller Använd för att spara ändringarna.
Se även
/headerName (Skapa en rubrikenhet från det angivna huvudet)
/headerUnit (Använd rubrikenhet IFC)
/reference (Använd namngiven modul IFC)
/translateInclude (Översätt inkludera direktiv till importdirektiv)