Visão geral controle servidor Web XML

Artigo
10/15/2014

Você pode usar o controle de servidor web Xml para exibir o conteúdo de um documento XML sem-formatação ou usando transformações em XSL.

Esse tópico contém:

Cenários
Segundo plano
Exemplos de código
Referência de Classe

Cenários

O controle de servidor web Xml lê XML e grava-o em uma página Web Forms na localidade do controle.Se uma transformação XSL (XSLT) for aplicada ao XML, a saída resultante transformada será processada na página.

Voltar ao topo

Segundo plano

Você pode usar o controle de servidor Web XML para gravar um documento XML, ou os resultados de uma transformação XSLT, em um página da Web ASP.ENT.A saída XML aparece na página da Web na localidade do controle.

Observação:
Para usar dados XML como a fonte para outros controles, como os controles Repeater, DataList, ou GridView, você pode usar o controle XmlDataSource.Para obter detalhes, consulte:Visão Geral sobre o Controle de Servidor Web XmlDataSource.

As informações XML e XSLT podem estar nos documentos externos, ou você pode incluir o XML em linha.Há duas maneiras para fazer referência a documentos externos usando definições de propriedade no controle de servidor web XML.Você pode fornecer um caminho para o documento XML na marca de controle, ou você pode carregar programaticamente os documentos XML e XSLT como objetos e, em seguida, passá-los para o controle.Se preferir incluir o XML em linha, escreva-lo entre as marcas de abertura e de fechamento do controle.

O documento XML para exibir é especificado pela definição de uma das propriedades listadas na tabela a seguir.Essas três propriedades representam os diferentes tipos de documentos XML que podem ser exibidos.Você pode exibir um System.Xml.XmlDocument, uma sequência XML ou um arquivo XML, definindo a propriedade apropriada.

Propriedade	Descrição
Document	Define o documento XML usando um objeto System.Xml.XmlDocument.
DocumentContent	Define o documento XML usando uma sequência de caracteres. Observação: Esta propriedade é geralmente definida declarativamente colocando o texto entre as marcas <asp:Xml> de abertura e fechamento do controle Xml.
DocumentSource	Define o documento XML usando um arquivo.

Pelo menos um das propriedades de documento deve ser definida para exibir um documento XML.Se mais de uma propriedade do documento XML for definida, o documento XML referenciado no último conjunto de propriedades é exibido.Os documentos nas outras propriedades são ignorados.

Opcionalmente, você pode definir propriedades para especificar um folha de estilos de Transformações XSL (XSLT) que formata o documento XML antes que ele seja gravado para o fluxo de saída.As propriedades representam os diferentes tipos de folhas de estilo de transformação XSL que podem ser usadas para formatar a um documento.Você pode formatar o documento XML com um objeto System.Xml.Xsl.XslCompiledTransform ou com um arquivo folha de estilos de Transformação em XSL, definindo a propriedade apropriada.Se nenhuma folha de estilos de transformação XSL for especificado, o documento XML é exibido usando o formato padrão.

Voltar ao topo