Compilatore XSLT (xsltc.exe)XSLT Compiler (xsltc.exe)

Il compilatore XSLT (xsltc.exe) consente di compilare fogli di stile XSLT e di generare un assembly.The XSLT compiler (xsltc.exe) compiles XSLT style sheets and generates an assembly. Il foglio di stile compilato può quindi essere passato direttamente nel metodo XslCompiledTransform.Load(Type).The compiled style sheet can then be passed directly into the XslCompiledTransform.Load(Type) method. Non è possibile generare assembly firmati con xsltc.exe.You cannot generate signed assemblies with xsltc.exe.

Lo strumento xsltc.exe è incluso in Visual Studio.The xsltc.exe tool is included with Visual Studio. Per altre informazioni, vedere Download di Visual Studio.For more information, see the Visual Studio Downloads.

SintassiSyntax

xsltc [options] [/class:<name>] <sourceFile> [[/class:<name>] <sourceFile>...]  

ArgomentoArgument

ArgomentoArgument DescrizioneDescription
sourceFile Consente di specificare il nome del foglio di stile.Specifies the name of the style sheet. Il foglio di stile deve essere un file locale o deve essere disponibile nella Intranet.The style sheet must be a local file or be located on the intranet.

OpzioniOptions

OpzioneOption DescrizioneDescription
/c[lass]: name/c[lass]: name Consente di specificare il nome della classe del foglio di stile successivo.Specifies the name of the class for the following style sheet. Il nome della classe può essere completo.The class name can be fully qualified.

Per impostazione predefinita, il nome della classe corrisponde al nome del foglio di stile.The class name defaults to the name of the style sheet. Ad esempio, se viene compilato il foglio di stile customers.xsl, il nome predefinito della classe sarà customers.For example, if the style sheet customers.xsl is compiled, the default class name is customers.
/debug[+|-]/debug[+|-] Consente di specificare se generare le informazioni per il debug.Specifies whether to generate debugging information.

Se si specifica + o /debug, il compilatore genererà le informazioni per il debug e le inserirà in un file del database di programma con estensione PDB.Specifying + or /debug, causes the compiler to generate debugging information and put it in a program database (PDB) file. Il nome del file PDB generato è assemblyName.pdb.The name of the generated PDB file is assemblyName.pdb.

Se si specifica l'argomento -, che è attivo quando /debug non è specificato, non verranno create informazioni per il debug.Specifying -, which is in effect if you do not specify /debug, causes no debug information to be created. Verrà generato un assembly finale.A retail assembly is generated. Nota: la compilazione in modalità di debug può influire significativamente sulle prestazioni di XSLT.Note: Compiling in debug mode can affect XSLT performance significantly.
/help Visualizza la sintassi e le opzioni di comando dello strumento.Displays command syntax and options for the tool.
/nologo Consente di disattivare la visualizzazione del messaggio di copyright del compilatore.Suppresses the compiler copyright message from displaying.
/platform: string/platform: string Consente di specificare le piattaforme in cui è possibile eseguire l'assembly.Specifies the platforms that the assembly can be run on. Di seguito sono illustrati i valori di piattaforma validi:The following describes the valid platform values:

x86: consente di compilare l'assembly in modo che sia possibile eseguirlo con la versione x86 compatibile di Common Language Runtime a 32 bit.x86 compiles your assembly to be run by the 32-bit, x86-compatible common language runtime

x64: consente di compilare l'assembly in modo che sia possibile eseguirlo con Common Language Runtime a 64 bit su un computer che supporta il set di istruzioni AMD64 o EM64T.x64 compiles your assembly to be run by the 64-bit common language runtime on a computer that supports the AMD64 or EM64T instruction set.

ItaniumItanium: consente di compilare l'assembly in modo che sia possibile eseguirlo con Common Language Runtime a 64 bit su un computer dotato di un processore ItaniumItanium. compiles your assembly to be run by the 64-bit common language runtime on a computer that has an ItaniumItanium processor.

anycpu: consente di compilare l'assembly in modo che sia possibile eseguirlo su qualsiasi piattaforma.anycpu compiles your assembly to run on any platform. Questa è l'impostazione predefinita.This is the default.
/out: assemblyName/out: assemblyName Specifica il nome dell'assembly che viene restituito come output.Specifies the name of the assembly that is output. Per impostazione predefinita, il nome dell'assembly corrisponde al nome del foglio di stile principale o a quello del primo foglio di stile se esistono più fogli.The assembly name defaults to the name of the main style sheet or the first style sheet if multiple style sheets are present.

Se il foglio di stile contiene script, questi vengono salvati in un assembly distinto.If the style sheet contains scripts, the scripts are saved to a separate assembly. I nomi degli assembly di script vengono generati dal nome dell'assembly principale.Script assembly names are generated from the main assembly name. Ad esempio, se è stato specificato CustOrders.dll come nome dell'assembly, al primo assembly di script verrà assegnato il nome CustOrders_Script1.dll.For example, if you specified CustOrders.dll for your assembly name, the first script assembly is named CustOrders_Script1.dll.
/settings: document+-, script+-, DTD+-,/settings: document+-, script+-, DTD+-, Consente di specificare se consentire l'uso di funzioni document(), script XSLT, o DTD (Document Type Definition) nel foglio di stile.Specifies whether to allow document() functions, XSLT script, or document type definition (DTD) in the style sheet.

Per impostazione predefinita, il supporto per DTD, per la funzione document() e gli script è disabilitato.The default behavior disables support for DTD, the document() function and scripting.
@ file@ file Consente di specificare un file che contiene le opzioni del compilatore.Lets you specify a file that contains the compiler options.
? Visualizza la sintassi e le opzioni di comando dello strumento.Displays command syntax and options for the tool.

NoteRemarks

Le soluzioni XSLT possono essere costituite da più moduli del foglio di stile.XSLT solutions can consist of multiple style sheet modules. Lo strumento xsltc.exe genera assembly dai fogli di stile.The xsltc.exe tool generates assemblies from style sheets. Gli assembly possono quindi essere passati direttamente nel metodo XslCompiledTransform.Load(Type).The assemblies can then be passed into the XslCompiledTransform.Load(Type) method. Tale comportamento può contribuire a ridurre i costi correlati alle prestazioni in alcuni scenari di distribuzione di XSLT.This can help decrease performance costs in some XSLT deployment scenarios.

Nota

È inoltre necessario includere anche l'assembly compilato come riferimento nell'applicazione.You must also include the compiled assembly as a reference in your application.

Lo strumento xsltc.exe non convalida i nomi di classe (/class:``name) o di assembly (/out:``assemblyName).The xsltc.exe tool does not validate the class (/class:``name) or assembly (/out:``assemblyName) names. Se i nomi non sono validi, CLR genera errori.Errors are thrown by the common language runtime if the names are not valid.

EsempiExamples

Il comando seguente consente di compilare il foglio di stile e di creare un assembly denominato booksort.dll.The following command compiles the style sheet and creates an assembly named booksort.dll.

xsltc booksort.xsl  

Il comando seguente consente di compilare il foglio di stile e di creare un assembly e un file PDB denominati rispettivamente booksort.dll e booksort.pdb.The following command compiles the style sheet and creates an assembly and PDB file that are named booksort.dll and booksort.pdb respectively.

xsltc booksort.xsl /debug  

Il comando seguente consente di compilare un foglio di stile che contiene l'elemento msxsl:script e di creare due assembly denominati calc.dll e calc_Script1.dll.The following command compiles a style sheet that contains an msxsl:script element and creates two assemblies named calc.dll and calc_Script1.dll.

xsltc /settings:script+ calc.xsl  

Il comando seguente consente di abilitare il supporto per gli script e per l'elaborazione DTD, nonché di creare due assembly denominati myTest.dll e myTest_Script1.dll.The following command enables DTD processing and script support and creates two assemblies named myTest.dll and myTest_Script1.dll.

xsltc /settings:DTD+,script+ /out:myTest calc.xsl  

Il comando seguente consente di compilare due moduli di fogli di stile e di creare un unico assembly denominato booksort.dll.The following command compiles two style sheet modules and creates a single assembly named booksort.dll.

xsltc booksort.xsl output.xsl  

Vedere ancheSee Also

XslCompiledTransform
Procedura: Eseguire una trasformazione XSLT con un assemblyHow to: Perform an XSLT Transformation by Using an Assembly
Trasformazioni XSLTXSLT Transformations