Übersicht über das XML-Webserversteuerelement

Článek
10/22/2014

Aktualisiert: November 2007

Mit dem Xml-Webserversteuerelement können Sie den Inhalt eines XML-Dokuments ohne Formatierung und ohne die Verwendung von XSL-Transformationen anzeigen.

Dieses Thema enthält folgende Abschnitte:

Szenarien
Hintergrund
Codebeispiele
Klassenreferenz

Szenarien

Ein Xml-Webserver-Steuerelement liest XML-Daten und schreibt sie an der Position des Steuerelements in eine ASP.NET-Webseite. Wenn eine XSL-Transformation (XSLT) auf XML-Daten angewendet wird, wird die daraus resultierende umgewandelte Ausgabe auf der Seite wiedergegeben.

Zurück nach oben

Hintergrund

Mit dem XML-Webserversteuerelement können Sie ein XML-Dokument oder die Ergebnisse einer XSL-Transformation (XSLT) in eine ASP.NET-Webseite schreiben. Die XML-Ausgabe wird an der Position des Steuerelements auf der Webseite angezeigt.

Hinweis:
Zur Verwendung von XML-Daten als Quelle für andere Steuerelemente wie Repeater, DataList oder GridView verwenden Sie das XmlDataSource-Steuerelement. Ausführliche Informationen finden Sie unter Übersicht über das XmlDataSource-Webserversteuerelement.

Die XML- und XSLT-Informationen können sich in externen Dokumenten befinden; Sie können XML aber auch inline einfügen. Es gibt zwei Möglichkeiten, im XML-Webserversteuerelement mithilfe von Eigenschafteneinstellungen auf externe Dokumente zu verweisen. Sie können im Steuerelementtag einen Pfad für das XML-Dokument angeben oder die XML- und XSLT-Dokumente programmgesteuert als Objekte laden und sie anschließend an das Steuerelement übergeben. Wenn Sie es vorziehen, XML inline einzubinden, stellen Sie es zwischen das Starttag und das Endtag des Steuerelements.

Das anzuzeigende XML-Dokument wird durch das Festlegen einer der in der folgenden Tabelle aufgelisteten Eigenschaften angegeben. Diese drei Eigenschaften stellen die unterschiedlichen Typen von XML‑Dokumenten dar, die angezeigt werden können. Sie können ein System.Xml.XmlDocument, eine XML-Zeichenfolge oder eine XML-Datei anzeigen, indem Sie die entsprechende Eigenschaft festlegen.

Eigenschaft	Beschreibung
Document	Legt das XML-Dokument mithilfe eines System.Xml.XmlDocument-Objekts fest.
DocumentContent	Legt das XML-Dokument mithilfe einer Zeichenfolge fest. Hinweis: Diese Eigenschaft wird im Allgemeinen deklarativ festgelegt, indem Text zwischen die öffnenden und schließenden <asp:Xml>-Tags des Xml-Steuerelements eingefügt wird.
DocumentSource	Legt das XML-Dokument mithilfe einer Datei fest.

Mindestens eine der XML-Dokumenteigenschaften muss festgelegt sein, um ein XML-Dokument anzuzeigen. Wenn mehrere XML-Dokumenteigenschaften festgelegt sind, wird das XML-Dokument angezeigt, auf das in der zuletzt festgelegten Eigenschaft verwiesen wird. Die Dokumente in den anderen Eigenschaften werden dann ignoriert.

Sie können bei Bedarf Eigenschaften festlegen, die ein XSL-Transformation (XSLT)-Stylesheet angeben, mit dem das XML-Dokument vor dem Schreiben in den Ausgabestream formatiert wird. Die Eigenschaften stellen die verschiedenen Typen von XSL-Transformation-Stylesheets dar, mit denen ein XML-Dokument formatiert werden kann. Sie können das XML-Dokument mit einem System.Xml.Xsl.XslCompiledTransform-Objekt oder mit einer XSL-Transformation-Stylesheetdatei formatieren, indem Sie die entsprechende Eigenschaft festlegen. Wenn kein XSL-Transformation-Stylesheet angegeben ist, wird das XML-Dokument unter Verwendung des Standardformats angezeigt.

Zurück nach oben