Üzenetfordítói feladat

A Windows Illesztőprogram-készlet (WDK) biztosítja a MessageCompiler feladatot, így futtathatja a MC.exe eszközt, amikor msBuild használatával hozza létre az illesztőprogramot. A MC.exehasználatáról a Message Compiler (MC.exe) című témakörben olvashat.

Az MSBuild a MessageCompile elem használatával küldi el a MessageCompiler-feladat paramétereit. A MessageCompile elem hozzáfér a projektfájlokban mc.exe elem metaadataihoz.

Az alábbi példa bemutatja, hogyan szerkesztheti a metaadatokat a .vcxproj fájlban.

<ItemGroup>
    <MessageCompile Include="a.mc">
      <GenerateBaselineResource>true</GenerateBaselineResource>
      <BaselineResourcePath>c:\test\</BaselineResourcePath>
    </MessageCompile>
</ItemGroup>

Az alábbi példa a parancssori meghívást mutatja be:

mc.exe –s "c:\test\" a.mc

A fenti példában az MSBuild a mc.exe-t hívja meg az a.mc fájlon, a –s kapcsolóval, mivel a GenerateBaselineResource metaadat igazra van állítva. Az MSBuild emellett az BaselineResourcePath metaadataival adja meg a –s kapcsoló argumentumát.

MessageCompiler tevékenységparaméter Elem metaadatai Eszközkapcsoló
források

Nem kötelező sztringparaméter. Megadja a lefordítandó manifesztfájl nevét. Megadja a lefordítandó üzenetfájl nevét.

@(MessageCompile)

<filename.man>

<filename.mc>

ANSIInputFile

Meghatározza, hogy a bemeneti fájl ANSI (alapértelmezett).

%(MessageCompile.ANSIInputFile) -a
ANSIMessageInBinFile

Megadja, hogy a . A BIN-fájlnak ANSI-nek kell lennie.

%(MessageCompile.ANSIMessageInBinFile) -Egy
EnableDebugOutputPath

Ha ez igaz értékre van állítva, engedélyezi az –x kapcsolót.

%(MessageCompile.EnableDebugOutputPath)
DebugOutputPath

Megadja azt a mappát, amelybe a fordító elhelyezi a .dbg C include fájlt. A .dbg fájlban az üzenetazonosítók szimbolikus nevekre vannak leképezve.

%(MessageCompile.DebugOutputPath) -x<elérési út>
EnableCallOutMacro

Felhasználói kód naplózás közbeni meghívására makrót ad hozzá. Ez a kapcsoló nem érvényes C# esetén, ezért figyelmen kívül van hagyva.

%(MessageCompile.EnableCallOutMacro) -co
EventmanPath

Az eventman.xsd fájl elérési útját adja meg.

%(MessageCompile.EventmanPath) -w<fájl>
GenerateBaselineResource

Ha ez igaz értékre van állítva, lehetővé teszi -s kapcsolót.

%(MessageCompile.GenerateBaselineResource)
BaselineResourcePath

Bináris erőforrást hoz létre szolgáltatónként. A MCGenResource.BIN összegző globális erőforrást hoz létre.

%(MessageCompile.BaselineResourcePath) -s<elérési útvonal>
GenerateC#LoggingClass

C# (felügyelt) naplózási osztályt hoz létre az FX3.5 Eventing osztály alapján.

%(MessageCompile.GenerateC#LoggingClass) -cs<névtér>
GenerateC#StaticLoggingClass

Statikus C# (felügyelt) naplózási osztályt hoz létre az FX3.5 Eventing osztály alapján.

%(MessageCompile.GenerateC#StaticLoggingClass) -css<névtér>
GeneratedFilesBaseName

Megadja a létrehozott fájlok alapnevét. Az alapértelmezett érték a bemeneti fájl alapneve.

%(MessageCompile.GeneratedFilesBaseName) -z<basename>
GeneratedHeaderPath

Ha ez igaz értékre van állítva, lehetővé teszi -h kapcsolót.

%(MessageCompile.GeneratedHeaderPath)
HeaderFilePath

Megadja a C-belefoglalási fájl létrehozásának elérési útját. Az alapértelmezett érték a ..

%(MessageCompile.HeaderFilePath) -h<elérési út>
GeneratedRcAndMessagesPath

Ha ez igaz értékre van állítva, engedélyezi a -r kapcsolót.

%(MessageCompile.GeneratedRcAndMessagesPath)
RCFilePath

Megadja az RC tartalmazó fájl elérési útját és az általa tartalmazott bináris üzenet erőforrásfájlokat. Az alapértelmezett érték a ..

%(MessageCompile.RCFilePath) -r<elérési út>
GenerateKernelModeLoggingMacros

Kernel módú naplózási makrókat hoz létre.

%(MessageCompile.GenerateKernelModeLoggingMacros) -kilométer
GenerateMOFFile

Alacsonyabb szintű támogatást hoz létre az összes létrehozott függvényhez és makróhoz. Az MOF-fájl a jegyzékből jön létre. Az MOF-fájl a "-h" kapcsoló által megadott helyre kerül.

%(MessageCompile.GenerateMOFFile) -mof
GenerateOLE2Header

Létrehozza az OLE2 fejlécfájlt. Az állapotkód definíciója helyett a HRESULT definíciót használja.

%(MessageCompile.GenerateOLE2Header) -o
Felhasználói módú naplózási makrók generálása

Felhasználói módú naplózási makrókat hoz létre.

%(MessageCompile.GenerateUserModeLoggingMacros) -um
HeaderExtension

Megadja a fejlécfájl bővítményét (1-3 karakter).

%(MessageCompile.Fejléckiterjesztés) -e<kiterjesztés>
MaximumMessageLength

Figyelmeztetést jelenít meg, ha az üzenetek mérete meghaladja <a hosszkarakterek méretét> .

%(MessageCompile.MaximumMessageLength) -m<hossz>
PrefixMacroName

Meghatározza az egyes létrehozott naplózási makrókra alkalmazott makrónév-előtagot. Az alapértelmezett érték az "EventWrite".

%(ÜzenetFordítás ElőtagMakróNév) -p<előtag>
RemoveCharsFromSymbolName

Meghatározza az egyes eseményszimbólumok neveinek elején lévő szöveget, amely eltávolítható a makrónevek formázása előtt. Az alapértelmezett érték NULL.

%(RemoveCharsFromSymbolName) -P<előtag>
SetCustomerbit

Beállítja az ügyfél bitet az összes üzenetazonosítóban.

%(ÜzenetFordít.ÁllítsaKliensBit) -c
TerminateMessageWithNull

Az üzenettáblákban null karaktert tartalmazó összes sztringet leállítja.

%(ÜzenetLezárásaNullával) -n
UnicodeInputFile

A bemeneti fájl Unicode.

%(MessageCompile.UnicodeInputFile) -u
Unicode üzenet bin fájlban

Üzeneteknek a .BIN fájlban Unicode formátumúnak kell lenniük (alapértelmezett).

%(MessageCompile.UnicodeMessageInBinFile) -U
UseBaseNameOfInput

Megadja, hogy a . A BIN fájlnévnek tartalmaznia kell .mc fájlnevet az egyediség érdekében.

%(MessageCompile. UseBaseNameOfInput) -b
UseDecimalValues

A fejlécfájl FACILTY és SEVERITY értékeit decimális értékben adja meg. A fejlécben lévő üzenetértékeket először decimális értékre állítja.

%(MessageCompile.UseDecimalValues) -d
ValidateAgainstBaselineResource

Ha ez igaz értékre van állítva, akkor létrehozza a -t kapcsolót.

%(MessageCompile.EllenőrzésAzAlapvetőErőforrássalSzemben)
BaselinePath

Összeveti az alaperőforrással való érvényesítést.

%(MessageCompile.BaselinePath) -t<elérési út>
Bőbeszédű

Részletes kimenetet ad meg.

%(MessageCompile.Verbose) -v
WinmetaPath

Megadja a winmeta.xml fájl elérési útját.

%(MessageCompile.WinmetaPath) -W<fájl>

Üzenetfordító (MC.exe)