Freigeben über

<xsl:output>-Element

  • Artikel

Gibt Optionen für die Serialisierung der Ergebnisstruktur an.

<xsl:output
  method = "xml" | "html" | "text" | QName 
  version = nmtoken 
  encoding = string
  omit-xml-declaration = "yes" | "no"
  standalone = "yes" | "no"
  doctype-public = string 
  doctype-system = string 
  cdata-section-elements = QNames 
  indent = "yes" | "no"
  media-type = string 
  />

Attribute

  • method
    Bestimmt die allgemein verwendete Methode zur Ausgabe der Ergebnisstruktur. Wenn kein Präfix vorhanden ist, bestimmt es eine in diesem Dokument angegebene Methode. Diese muss "xml", "html", "text", oder ein qualified name (QName) sein, der kein NCName ist).Wenn ein Präfix vorhanden ist, wird dieses erweitert und bestimmt die Ausgabemethode.

    Der Standard für das method-Attribut wird wie folgt ausgewählt. Wenn eine der folgenden Bedingungen erfüllt ist, stellt "html" die Standardausgabemethode dar:

    • Der Stammknoten der Ergebnisstruktur weist ein untergeordnetes Element auf.

    • Der erweiterte Name des ersten untergeordneten Elements des Stammknotens (d. h. das Dokumentelement) der Ergebnisstruktur weist einen lokalen Teil "html" (in allen Klein-/Großschreibungsvarianten) sowie einen Null-Namespace-URI auf.

    • Alle Textknoten, die dem ersten untergeordneten Element des Stammknotens der Ergebnisstruktur vorangestellt sind, enthalten nur Leerraumzeichen.

    Andernfalls ist die Standardausgabemethode "xml". Die Standardausgabemethode sollte verwendet werden, wenn keine <xsl:output>-Elemente vorhanden sind oder keines der <xsl:output>-Elemente einen Wert für das method-Attribut angibt.

    Wenn XHTML ausgegeben werden soll, ist die Ausgabemethode "xml" effektiver als "html".

  • version
    Gibt Version 1.0 bei der "xml"-Ausgabemethode an. Dies wird in der XML-Ausgabedeklaration als <?xml version="1.0"?> angezeigt.
  • encoding
    Gibt die bevorzugte Zeichenverschlüsselung an, die der Parser zum Verschlüsseln der Zeichenfolgen als Bytefolgen verwendet. Der Wert des Attributs wird ohne Berücksichtigung der Groß- und Kleinschreibung behandelt. Er darf nur aus druckbaren ASCII-Zeichen bestehen, und es muss sich um einen registrierten Zeichensatz handeln, oder er muss mit "x-" beginnen.
  • omit-xml-declaration
    Gibt an, ob der XSLT-Prozessor eine XML-Deklaration ausgibt. Der Wert ist yes oder no.
  • standalone
    Gibt an, ob der XSLT-Prozessor eine eigenständige Dokumentdeklaration ausgibt. Der Wert ist yes oder no.
  • doctype-public
    Gibt den öffentlichen Bezeichner an, der in der DTD verwendet wird.
  • doctype-system
    Gibt den Systembezeichner an, der in der DTD verwendet wird.
  • cdata-section-elements
    Gibt eine Liste der Qualifizierte Namen der Elemente an, deren untergeordnete Textknoten mithilfe der CDATA-Abschnitte ausgegeben werden sollen.
  • indent
    Gibt zusätzlichen Leerraum an, der bei der Ausgabe der Ergebnisstruktur hinzugefügt wird. Der Wert muss yes oder no sein.
  • media-type
    Gibt den Medientyp (MIME-Inhaltstyp) der Daten an, die bei der Ausgabe der Ergebnisstruktur entstehen.

Elementinformationen

Anzahl der Vorkommen

Unbegrenzt

Übergeordnete Elemente

xsl:stylesheet, xsl:transform

Untergeordnete Elemente

(Keine untergeordneten Elemente)

Hinweise

Ein Stylesheet kann mehrere <xsl:output> -Elemente und außerdem Stylesheets mit <xsl:output>-Elementen enthalten. Alle im Stylesheet enthaltenen <xsl:output>-Elemente werden zu einem einzelnen effektiven <xsl:output>-Element zusammengeführt.Wenn mehr als ein derartiger Wert für ein Attribut vorhanden ist, wird ein Fehler angezeigt. Die Werte der Attribute erhalten einen Standardwert, nachdem die <xsl:output>-Elemente zusammengeführt wurden. Unterschiedliche Ausgabemethoden können zu unterschiedlichen Standardwerten für ein Attribut führen.

Beispiele

Die folgenden Themen bieten Beispiele für <xsl:output>.