Kontrolki XML w ASP.NET

Podręcznik referencyjny kontrolki serwera Web

Definicja i użycie

Kontrolki XML są używane do wyświetlania dokumentów XML lub wyników transformacji XSL.

Właściwości

Jedną z tych właściwości, Document, DocumentContent lub DocumentSource, można ustawić, aby określić dokument XML do wyświetlenia. Te trzy właściwości reprezentują różne typy dokumentów XML, które można wyświetlić. Ustawiając odpowiednie właściwości, można wyświetlić System.Xml.XmlDocument, ciąg XML lub plik XML.

Ustawienie jednej z tych właściwości, Transform lub TransformSource, pozwala na wybór określonego szablonu XSL transformacji (XSLT), który formatuje dokument XML przed zapisaniem go do strumienia wyjściowego. Te dwie właściwości reprezentują różne typy szablonów XSL transformacji dostępnych do formatowania dokumentów XML. Ustawiając odpowiednie właściwości, można formatować dokument XML za pomocą obiektu System.Xml.Xsl.XslCompiledTransform lub pliku szablonu XSL transformacji. Jeśli nie określono szablonu XSL transformacji, dokument XML jest wyświetlany w domyślnym formacie.

Klasa Xml oferuje również właściwość TransformArgumentList, która pozwala na dostarczenie XSL transformacji szablonu ze zmiennymi opcjonalnymi. Te parametry mogą być parametrami XSL transformacji (XSLT) lub rozszerzonymi obiektami.

Właściwości Opis .NET
Document Nie zalecane do użycia. Określa dokument XML za pomocą obiektu System.Xml.XmlDocument. 1.0
DocumentContent Określa ciąg XML. 1.0
DocumentSource Określa ścieżkę do dokumentu XML wyświetlanego w kontrolce XML. 1.0
runat Określa, że ta kontrolka jest kontrolką serwerową. Musi być ustawiona na "server". 1.0
Transform Użyj obiektu System.Xml.Xsl.XslTransform, aby sformatować dokument XML. 1.0
TransformArgumentList Zawiera listę opcjonalnych parametrów przekazywanych do szablonu i używanych w transformacji języka rozszerzonego XSLT (XSLT). 　
TransformSource Określa ścieżkę do pliku transformaty XSL. 　
XPathNavigator Model kursora używany do nawigacji i edycji danych XML związanych z kontrolką XML. 　

Standardowe właściwości kontrolki

AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Kontrolki, 
EnableTheming, EnableViewState, ID, NamingContainer, Strona, Rodzic, Strona, 
TemplateControl, TemplateSourceDirectory, UniqueID, Widoczny

Aby uzyskać pełne opisanie, odwiedźStandardowe właściwości kontrolki.

Przykład

XML
Ten przykład pokazuje, jak używać kontrolki XML do wyświetlania wyników transformaty XSL.

Podręcznik referencyjny kontrolki serwera Web