Cenni preliminari sul controllo server Web XML

Articolo
10/22/2014

Aggiornamento: novembre 2007

È possibile utilizzare il controllo server Web Xml per visualizzare il contenuto di un documento XML senza formattarlo o applicarvi le trasformazioni XSL.

Vengono illustrati i seguenti argomenti:

Scenari
Background
Esempi di codice
Riferimento alle classi

Scenari

Tramite un controllo server Web Xml è possibile leggere codice XML e scriverlo in una pagina Web ASP.NET nel punto in cui si trova il controllo. Se si applica una trasformazione XSL (XSLT) al codice XML, nella pagina verrà eseguito il rendering dell'output trasformato risultante.

Torna all'inizio

Background

È possibile utilizzare il controllo server Web XML per scrivere un documento XML, o i risultati di una trasformazione XSL (XSLT), in una pagina Web ASP.NET. L'output XML viene visualizzato nella pagina Web nel punto in cui si trova il controllo.

Nota:
Per utilizzare i dati XML come origine per altri controlli, quali Repeater, DataList e GridView, è possibile utilizzare il controllo XmlDataSource. Per informazioni dettagliate, vedere Cenni preliminari sul controllo server Web XmlDataSource.

Le informazioni XML e XSLT possono essere contenute in documenti esterni oppure è possibile includere l'XML inline. Utilizzando le impostazioni delle proprietà nel controllo server Web XML, è possibile fare riferimento a documenti esterni in due modi diversi: fornendo un percorso al documento XML nel tag di controllo oppure caricando a livello di codice i documenti XML e XSLT come oggetti, quindi passandoli al controllo. Se si preferisce includere l'XML inline, scriverlo tra i tag di apertura e di chiusura del controllo.

Il documento XML da visualizzare viene specificato impostando una delle proprietà riportate nella tabella seguente. Le tre proprietà rappresentano i diversi tipi di documenti XML che possono essere visualizzati. Impostando la proprietà adeguata, è possibile visualizzare un oggetto System.Xml.XmlDocument, una stringa XML oppure un file XML.

Proprietà	Descrizione
Document	Imposta il documento XML utilizzando un oggetto System.Xml.XmlDocument.
DocumentContent	Imposta il documento XML utilizzando una stringa. Nota: La proprietà viene in genere impostata in modo dichiarativo, inserendo il testo tra i tag <asp:Xml> di apertura e di chiusura del controllo Xml.
DocumentSource	Imposta il documento XML utilizzando un file.

Almeno una delle proprietà del documento XML deve essere impostata in modo da determinare la visualizzazione di un documento XML. Se sono impostate più proprietà del documento XML, viene visualizzato il documento al quale fa riferimento l'ultima proprietà impostata. I documenti nelle altre proprietà saranno ignorati.

Se lo si desidera, è possibile impostare le proprietà in modo da specificare un foglio di stile per la trasformazione XSL (XSLT) in base al quale formattare il documento prima che venga scritto nel flusso di output. Le due proprietà rappresentano i due tipi di foglio di stile per la trasformazione XSL che è possibile utilizzare per formattare il documento XML. È possibile formattare il documento XML tramite un oggetto System.Xml.Xsl.XslCompiledTransform o un file del foglio di stile per la trasformazione XSL impostando la proprietà appropriata. Se non è specificato alcun foglio di stile per la trasformazione XSL, il documento XML viene visualizzato utilizzando il formato predefinito.

Torna all'inizio