ASP.NET XML-kontrolli

Määrittely ja käyttö

XML-kontrolli käytetään XML-dokumenttien tai XSL-muunnoksen tulosten näyttämiseen.

Ominaisuudet

Määrittämällä yhden näistä kolmesta ominaisuudesta Document, DocumentContent tai DocumentSource voidaan määrittää näytettävä XML-dokumentti. Nämä ominaisuudet edustavat erilaisia XML-dokumentteja, joita voidaan näyttää. Määrittämällä sopivat ominaisuudet voidaan näyttää System.Xml.XmlDocument, XML-merkkijono tai XML-tiedosto.

Määrittämällä joko Transform- tai TransformSource-ominaisuuden voidaan valita XSL-muuntostilteen (XSLT) määrittäminen, joka muotoilee XML-dokumentin ennen kuin se kirjoitetaan ulostulovirtaan. Nämä ominaisuudet edustavat erilaisia XSL-muuntostiloja, joita voidaan käyttää XML-dokumentin muotoiluun. Määrittämällä sopivat ominaisuudet voidaan muotoilla XML-dokumentteja System.Xml.Xsl.XslCompiledTransform-objektin tai XSL-muuntostilteen tiedoston avulla. Jos XSL-muuntostiltaa ei määritetä, XML-dokumentti näytetään oletusmuodossa.

Xml-luokka tarjoaa myös TransformArgumentList-ominaisuuden, joka mahdollistaa valinnaisparametrien sisältävän XSL-muuntostilteen. Nämä parametrit voivat olla XSL-muuntoparametreja tai laajennettuja objekteja.

Ominaisuudet Kuvaus .NET
Document Ei suositella. Määrittää XML-dokumentin System.Xml.XmlDocument-objektin avulla. 1.0
DocumentContent Määrittää XML merkkijonon. 1.0
DocumentSource Määrittää XML-dokumentin polun, joka näytetään Xml ohjaimessa. 1.0
runat Määrittää, että tämä ohjain on palvelinohjain. On asetettava arvoksi "server". 1.0
Transform Muotoile XML-dokumentti System.Xml.Xsl.XslTransform-objektin avulla. 1.0
TransformArgumentList Sisältää valinnaisen parametrien listan, jotka siirretään tyyleihin ja käytetään laajennetussa tyyleihin muunnoskielissä (XSLT).  
TransformSource Määrittää XSL muunnos tiedoston polun.  
XPathNavigator Käyttää navigointiin ja muokkaamiseen XML ohjaimen kanssa liittyvää XML tietoa oleva kursorimalli.  

Ohjain standard ominaisuudet

AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Ohjaimet, 
EnableTheming, EnableViewState, ID, NamingContainer, Sivu, Vanhempi, Sivusto, 
TemplateControl, TemplateSourceDirectory, UniqueID, Näkyvä

Täydelliselle kuvaukselle vieraileOhjain standard ominaisuudet.

Esimerkki

XML
Tämä esimerkki näyttää, miten XML ohjainta käytetään XSL muunnoksen tulosten näyttämiseen.