Opcje danych wyjściowych klasy XslCompiledTransform
W tym artykule omówiono dostępne opcje danych wyjściowych XSLT. Opcje danych wyjściowych można określić w arkuszu stylów lub w metodzie Transform .
xsl:output, element
Element xsl:output
określa opcje dla danych wyjściowych. Typ danych wyjściowych określony przez Transform metodę określa zachowanie xsl:output
opcji.
W poniższej tabeli opisano zachowanie każdego atrybutu dostępnego xsl:output
dla elementu, gdy typ danych wyjściowych jest strumieniem lub .TextWriter
Attribute name | Zachowanie |
---|---|
połączenia | Obsługiwane. |
version | Ignorowane. Wersja jest zawsze 1.0 dla plików XML i 4.0 dla języka HTML. |
encoding | Ignorowane podczas wyprowadzania do elementu TextWriter. TextWriter.Encoding Zamiast tego jest używana właściwość . |
pomijanie deklaracji xml | Obsługiwane. |
niezależne | Obsługiwane. |
dokument -public | Obsługiwane. |
doctype-system | Obsługiwane. |
cdata-section-elements | Obsługiwane. |
Wcięcie | Obsługiwane. |
typ nośnika | Obsługiwane. |
Wysyłanie danych wyjściowych do elementu XmlWriter
Jeśli arkusz stylów używa xsl:output
elementu , a typ danych wyjściowych jest obiektem XmlWriter , należy użyć XslCompiledTransform.OutputSettings właściwości podczas tworzenia XmlWriter obiektu. Właściwość XslCompiledTransform.OutputSettings zwraca XmlWriterSettings obiekt zawierający informacje pochodzące z xsl:output
elementu skompilowanego arkusza stylów. Ten XmlWriterSettings obiekt można przekazać do XmlWriter.Create metody w celu utworzenia XmlWriter obiektu z poprawnymi ustawieniami.
Typy danych wyjściowych
Poniższa lista zawiera opis typów danych wyjściowych dostępnych w poleceniu Transform .
XmlWriter
Klasa XmlWriter zapisuje strumienie XML lub pliki. Można określić funkcje do obsługi obiektu XmlWriter , w tym opcje danych wyjściowych, przy użyciu XmlWriterSettings klasy . Klasa XmlWriter jest integralną częścią System.Xml struktury. Ten typ danych wyjściowych służy do potoku wyników wyjściowych do innego procesu XML.
Ciąg
Użyj tego typu danych wyjściowych, aby określić identyfikator URI pliku wyjściowego.
Stream
Strumień to abstrakcja sekwencji bajtów, takich jak plik, urządzenie wejściowe/wyjściowe, potok komunikacji między procesami lub gniazdo TCP/IP. Klasa Stream i jej klasy pochodne zapewniają ogólny widok tych różnych typów danych wejściowych i wyjściowych, izolując programistę z określonych szczegółów systemu operacyjnego i urządzeń bazowych.
Użyj tego typu danych wyjściowych, aby wysyłać dane do strumienia wyjściowego FileStream(MemoryStreamResponse.OutputStream
).
TextWriter
Zapisuje TextWriter sekwencyjne znaki. Jest implementowany w StringWriter klasach i StreamWriter , które zapisują znaki w ciągach lub strumieniach, odpowiednio. Użyj tego typu danych wyjściowych, gdy chcesz wyświetlić dane wyjściowe w ciągu.
Uwagi
Podczas zapisywania pustych tagów spacja jest zapisywana między ostatnim znakiem nazwy elementu a ukośnikiem odwrotnym, <myElement />
na przykład. Dzięki temu starsze przeglądarki poprawnie wyświetlają wygenerowane strony HTML.