Controle XML do ASP.NET
Definição e uso
O controle XML é usado para exibir documentos XML ou resultados de transformação XSL.
Propriedade
Para especificar o documento XML a ser exibido, configure uma das propriedades Document, DocumentContent ou DocumentSource. Essas propriedades representam diferentes tipos de documentos XML que podem ser exibidos. Ao definir a propriedade apropriada, é possível exibir System.Xml.XmlDocument, uma string XML ou um arquivo XML.
Ao definir uma das propriedades Transform ou TransformSource, é possível escolher um estilo de tabela de transformação (XSLT) específico, que formata o documento XML antes de ser escrito no fluxo de saída. Essas propriedades representam diferentes tipos de estilos de tabela de transformação XSLT disponíveis para formatar documentos XML. Ao definir a propriedade apropriada, é possível formatar documentos XML usando o objeto System.Xml.Xsl.XslCompiledTransform ou um arquivo de estilo de tabela de transformação XSLT. Se não for especificado um estilo de tabela de transformação XSLT, o documento XML será exibido no formato padrão.
A classe Xml também oferece a propriedade TransformArgumentList, que permite fornecer um estilo de tabela de transformação XSL com parâmetros opcionais. Esses parâmetros podem ser parâmetros de transformação (XSLT) ou objetos de extensão.
| Propriedade | Descrição | .NET |
|---|---|---|
| Document | Desaconselhado. Define o documento XML usando o objeto System.Xml.XmlDocument. | 1.0 |
| DocumentContent | Define a string XML. | 1.0 |
| DocumentSource | Define o caminho do documento XML exibido no controle XML. | 1.0 |
| runat | Define que o controle é um controle de servidor. Deve ser configurado como "server". | 1.0 |
| Transform | Use o objeto System.Xml.Xsl.XslTransform para formatar o documento XML. | 1.0 |
| TransformArgumentList | Contém uma lista de parâmetros opcionais passados para a tabela de estilo e usados na conversão de linguagem de estilo estendida (XSLT). | |
| TransformSource | Define o caminho do arquivo de transformação XSL. | |
| XPathNavigator | Modelo de cursor usado para navegar e editar dados XML associados ao controle XML. |
Propriedades de Controle Padrão
AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site TemplateControl, TemplateSourceDirectory, UniqueID, Visible
Para uma descrição completa, acessePropriedades de Controle Padrão.
Exemplo
- XML
- Este exemplo mostra como usar o controle XML para exibir o resultado da transformação XSL.
