XSLT-compiler (xsltc.exe)
De XSLT-compiler (xsltc.exe) compileert XSLT-opmaakmodellen en genereert een assembly. Het gecompileerde opmaakmodel kan vervolgens rechtstreeks in de XslCompiledTransform.Load(Type) methode worden doorgegeven. U kunt ondertekende assembly's niet genereren met xsltc.exe.
Notitie
Scriptblokken worden alleen ondersteund in .NET Framework. Ze worden niet ondersteund op .NET Core of .NET 5 of hoger.
Het hulpprogramma xsltc.exe is opgenomen in Visual Studio. Zie de Visual Studio Downloads voor meer informatie.
Syntaxis
xsltc [options] [/class:<name>] <sourceFile> [[/class:<name>] <sourceFile>...]
Argument
| Argument | Beschrijving |
|---|---|
sourceFile |
Hiermee geeft u de naam van het opmaakmodel op. Het opmaakmodel moet een lokaal bestand zijn of zich op het intranet bevinden. |
Opties
| Optie | Omschrijving |
|---|---|
/c[lass]: name |
Hiermee geeft u de naam van de klasse voor het volgende opmaakmodel. De klassenaam kan volledig worden gekwalificeerd. De klassenaam wordt standaard ingesteld op de naam van het opmaakmodel. Als het opmaakmodel customers.xsl bijvoorbeeld wordt gecompileerd, is de standaardklassenaam klanten. |
/debug[+|-] |
Hiermee geeft u op of foutopsporingsgegevens moeten worden gegenereerd.+ Als u opgeeft of/debug, zorgt u ervoor dat de compiler foutopsporingsgegevens genereert en in een PDB-bestand (program database) plaatst. De naam van het gegenereerde PDB-bestand is assemblyName.pdb.-Als u dit niet opgeeft/debug, wordt er geen foutopsporingsinformatie gemaakt. Er wordt een retailassembly gegenereerd. Opmerking: Compileren in de foutopsporingsmodus kan van invloed zijn op XSLT-prestaties. |
/help |
Geeft de opdrachtsyntaxis en opties voor het hulpprogramma weer. |
/nologo |
Onderdrukt het copyrightbericht van de compiler dat het wordt weergegeven. |
/platform: string |
Hiermee geeft u de platforms waarop de assembly kan worden uitgevoerd. Hieronder worden de geldige platformwaarden beschreven:x86 compileert uw assembly die moet worden uitgevoerd door de 32-bits, x86-compatibele common language runtimex64 compileert uw assembly die moet worden uitgevoerd door de 64-bits algemene taalruntime op een computer die ondersteuning biedt voor de AMD64- of EM64T-instructieset.Itanium compileert uw assembly om te worden uitgevoerd door de 64-bits algemene taalruntime op een computer met een Itanium-processor. anycpu compileert uw assembly om te worden uitgevoerd op elk platform. Dit is de standaardinstelling. |
/out: assemblyName |
Hiermee geeft u de naam op van de assembly die uitvoer is. De assemblynaam wordt standaard ingesteld op de naam van het hoofdmodel of het eerste opmaakmodel als er meerdere opmaakmodellen aanwezig zijn. Als het opmaakmodel scripts bevat, worden de scripts opgeslagen in een afzonderlijke assembly. Namen van scriptassembly's worden gegenereerd op basis van de naam van de hoofdassembly. Als u bijvoorbeeld CustOrders.dll hebt opgegeven voor de assemblynaam, krijgt de eerste scriptassembly de naam CustOrders_Script1.dll. |
/settings: document+-, script+-, DTD+-, |
Hiermee geeft u op of functies, XSLT-script of documenttypedefinitie (DTD) in het opmaakmodel moeten worden toegestaan document() .Het standaardgedrag schakelt ondersteuning voor DTD, de document() functie en scripting uit. |
@ file |
Hiermee kunt u een bestand opgeven dat de compileropties bevat. |
? |
Geeft de opdrachtsyntaxis en opties voor het hulpprogramma weer. |
Opmerkingen
XSLT-oplossingen kunnen bestaan uit meerdere opmaakmodellen. Met het hulpprogramma xsltc.exe worden assembly's gegenereerd op basis van opmaakmodellen. De assembly's kunnen vervolgens worden doorgegeven aan de XslCompiledTransform.Load(Type) methode. Dit kan helpen bij het verlagen van de prestatiekosten in sommige XSLT-implementatiescenario's.
Notitie
U moet ook de gecompileerde assembly opnemen als referentie in uw toepassing.
Het hulpprogramma xsltc.exe valideert de namen van de klasse (/class:naam) of assembly (/out:assemblyName) niet. Fouten worden veroorzaakt door de algemene taalruntime als de namen niet geldig zijn.
Voorbeelden
Met de volgende opdracht compileert u het opmaakmodel en maakt u een assembly met de naam booksort.dll.
xsltc booksort.xsl
Met de volgende opdracht wordt het opmaakmodel gecompileerd en wordt een assembly- en PDB-bestand gemaakt met de naam booksort.dll en booksort.pdb.
xsltc booksort.xsl /debug
Met de volgende opdracht compileert u een opmaakmodel dat een msxsl:script element bevat en maakt u twee assembly's met de naam calc.dll en calc_Script1.dll.
xsltc /settings:script+ calc.xsl
Met de volgende opdracht kunt u DTD-verwerking en scriptondersteuning inschakelen en twee assembly's maken met de naam myTest.dll en myTest_Script1.dll.
xsltc /settings:DTD+,script+ /out:myTest calc.xsl
Met de volgende opdracht worden twee opmaakmodelmodules gecompileerd en wordt één assembly gemaakt met de naam booksort.dll.
xsltc booksort.xsl output.xsl
