Condividi tramite


Opzioni di output nella classe XslCompiledTransform

Questo articolo illustra le opzioni di output XSLT disponibili. È possibile specificare le opzioni di output nel foglio di stile o nel Transform metodo .

Elemento xsl:output

L'elemento xsl:output specifica le opzioni per l'output. Il tipo di output specificato dal Transform metodo determina il comportamento delle xsl:output opzioni.

Nella tabella seguente viene descritto il comportamento per ognuno degli attributi disponibili nell'elemento xsl:output quando il tipo di output è un flusso o un oggetto TextWriter.

Nome dell'attributo Comportamento
method Supportato.
version Ignorato. La versione è sempre 1.0 per XML e 4.0 per HTML.
codifica Ignorato durante l'output in un oggetto TextWriter. La TextWriter.Encoding proprietà viene invece utilizzata.
omit-xml-declaration Supportato.
Autonomo Supportato.
doctype-public Supportato.
doctype-system Supportato.
cdata-section-elements Supportato.
Trattino Supportato.
tipo di supporto Supportato.

Invio di output a un XmlWriter

Se il foglio di stile utilizza l'elemento xsl:output e il tipo di output è un XmlWriter oggetto , è necessario utilizzare la XslCompiledTransform.OutputSettings proprietà quando si crea l'oggetto XmlWriter . La XslCompiledTransform.OutputSettings proprietà restituisce un XmlWriterSettings oggetto che contiene informazioni derivate dall'elemento xsl:output di un foglio di stile compilato. Questo XmlWriterSettings oggetto può essere passato al XmlWriter.Create metodo per creare un XmlWriter oggetto con le impostazioni corrette.

Tipi di output

Nell'elenco seguente vengono descritti i tipi di output disponibili nel Transform comando .

Xmlwriter

La XmlWriter classe scrive flussi o file XML. È possibile specificare le funzionalità da supportare nell'oggetto XmlWriter , incluse le opzioni di output, usando la XmlWriterSettings classe . La XmlWriter classe è parte integrante del System.Xml framework. Usare questo tipo di output per eseguire la pipeline dei risultati di output in un altro processo XML.

string

Usare questo tipo di output per specificare l'URI del file di output.

Stream

Un flusso è un'astrazione di una sequenza di byte, ad esempio un file, un dispositivo di input/output, una pipe di comunicazione tra processi o un socket TCP/IP. La Stream classe e le relative classi derivate forniscono una visualizzazione generica di questi diversi tipi di input e output, isolando il programmatore dai dettagli specifici del sistema operativo e dei dispositivi sottostanti.

Usare questo tipo di output per inviare dati a un FileStreamflusso di outputResponse.OutputStream (MemoryStream).

TextWriter

Scrive TextWriter caratteri sequenziali. Viene implementato nelle StringWriter classi e StreamWriter , rispettivamente, che scrivono caratteri in stringhe o flussi. Usare questo tipo di output quando si vuole restituire una stringa.

Note

Quando si scrivono tag vuoti, viene scritto uno spazio tra l'ultimo carattere del nome dell'elemento e la barra rovesciata, <myElement /> ad esempio. Ciò consente ai browser meno recenti di visualizzare correttamente le pagine HTML generate.

Vedere anche