INFORMATICA MEDICA

INFORMATICA MEDICA
15. Usare XML con ADO.NET
Prof. Mauro Giacomini

Sommario
• Relazione fra DataSet e XML
• Sincronizzazione fra DataSet e
XMLDataDocument
• Manipolazione di documenti XML con
XMLDataDocument
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

DataSet e XML
• Metodi di DataSet per interagire con XML in
lettura e scrittura
• Generare dei file XML per rappresentare
• la struttura del DataSet (schema)
• Il contenuto dei DataTable (contenuto)
• Oppure schema e contenuti assieme
• Leggere file XML per produrre
• Strutture dati all’interno di DataSet
• Caricare dati in una struttura esistente
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

Metodo WriteXmlSchema
• Metodo della classe DataSet
• Consente di generare un file XML
contenente tutte le informazioni necessarie
a ricreare un DataSet con la stessa struttura
del DataSet che lo ha generato
• Dim ds as New DataSet
• Ds.WriteXmlSchema ()
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

Filestream
• Oggetto del namespace System.IO che consente di
• scrivere i dati contenuti in una struttura dati (dati in un array ad
esempio) in un file
• Leggere i dati contenuti in un file e trasferirli in una struttura dati
• Da specificare:
• Nome file
• Modo di agire sul file
• Create: crea un nuovo file
• Append: aggiunge alla fine del file
• Open: apertura in lettura
• Dim Fs as New FileStream (strNomeFile, _
FileMode.Create)
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

XmlTextWriter
• Appartiene al namespace System.Xml ma richiede
anche variabili da System.Text
• Consente di scrivere file espressi in formato Xml
Dim Fs as New FileStream (strNomeFile, FileMode.Create)
Dim Xw as New XmlTextWriter (Fs, Encoding.Unicode)
• Vuole un file stream dove mettere l’uscita e gli
strumenti di codifica
• Può essere passato a un WriteXmlSchema
ds.WriteXmlSchema (xw)
xw.Close
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

WriteXml
• Si esegue per trasferire in formato XML il contenuto del
dataset.
• Oltre al file dove scrivere si deve indicare anche il
parametro XmlWriteMode
• Valori di XmlWriteMode
IgnoreSchema: scrive solo il contenuto del DataSet senza
informazioni sullo schema
WriteSchema: scrive sia il contenuto del DataSet sia lo schema
DiffGram: scrive il contenuto del DataSet in formato DiffGram
(contenuti originali e quelli correnti)
• In alcuni casi si possono mettere anche solo i cambiamenti:
eseguire il metodo GetChanges del DataSet e poi scrivere
il file XML del DataSet appena generato
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

Uso di WriteXml
Dim ds as New DataSet
Dim fs as New FileStream (“Schema.xml”, FileMode.Create)
Dim xw as New XmlTextWriter (fs, Encoding.Unicode)
ds.WriteXml (xw, XmlWriteMode.IgnoreSchema)
Oppure
ds.WriteXml (xw, XmlWriteMode.WriteSchema)
Oppure
ds.WriteXml (xw, XmlWriteMode.DiffGram)
xw.Close
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

ReadXmlSchema
• Consente di leggere un file XML con
informazioni con lo schema di un dataset e
di generare in un DataSet dell’applicazione le
stesse tabelle e le stesse relazioni tra di loro.
• Dim ds As New DataSet
• Dim fs As New FileStream (“Schema.xml”, FileMode.Open)
• Dim xr As New XmlTextReader (fs)
• ds.ReadXmlSchema (xr)
• xr.Close
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

ReadXml
• Consente di leggere un file XML contenente
dei dati al fine di caricarli in DataTable di
DataSet.
• Se il file XML contiene anche gli schemi il
metodo ReadXml consente di costruire anche
le strutture dati richieste.
• Per questo ReadXml ha un parametro in più:
XmlReadMode
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

Valori di XmlReadMode (1)
• IgnoreSchema: ignora ogni informazione relativa
allo schema eventualmente contenuta nel file e
carica i dati nei DataTable già presenti nel DataSet
• ReadSchema: Legge le informazioni relative allo
schema contenute nel file, genera i DataTable e
dopo carica i dati in esse. Se il DataSet conteneva
già altre tabelle, il metodo aggiunge quelle
richieste, ma si genera un errore se si cerca di
creare un oggetto già esistente
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

Valori di XmlReadMode (2)
• InferSchema: ignora le informazioni relative allo
schema nel file e cerca di inferire lo schema dai dati
presenti. Se il DataSet contiene già uno schema, il
metodo aggiunge le tabelle o le colonne
eventualmente necessarie
• DiffGram: serve per leggere un file contenente un
DiffGram. Il DataSet ricevente è aggiornato con le
modifiche riportate nel file.
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

Valori di XmlReadMode (3)
• Fragment: serve per leggere file XML generati a
seguito dell’esecuzione di query di lettura che
restituiscano i dati in formato XML
• Auto: sceglie il valore più appropriato di questo
parametro in funzione del contenuto del file e dello
stato del DataSet.
Dim ds As New DataSet
Dim fs As New FileStream (“Schema.xml”,FileMode.Open)
Dim xr As New XmlTextReader (fs)
Ds.ReadXml(xr, XmlReadMode.IgnoreSchema)
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

GetXmlSchema - GetXml
• Sempre metodi del DataSet
• GetXmlSchema: restituisce una stringa con la
rappresentazione in formato XML dello schema del
DataSet
• GetXml: restituisce una stringa con la
rappresentazione in formato XML dei dati del
DataSet (non ha parametri simili a XmlWriteMode,
funziona in modo simile a IgnoreSchema).
• Aggiunta di una form di dettaglio dove in una
textbox vegano visualizzati di risultati delle funzioni
GetXmlSchema e GetXml.
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

XmlDataDocument
• Oggetto utile per mantenere la sincronizzazione tra
la rappresentazione relazionale dei dati (DataSet) e
quella gerarchica (XML)
• Del namespace System.Xml
• Per caricare
Dim xd As New XmlDataDocument
xd.load(“f1.xml”)
• Per specificare un legame a un DataSet già
istanziato e popolato
• Dim xd As New XmlDataDocument (ds)
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

Esempio di sincronizzazione
• Se non c’è il DataSet, va creato, sincronizzarlo con il
XmlData e popolare solo uno dei due oggetti
Dim ds As New DataSet
Dim xd As New XmlDataDocument (ds)
xd.load(“file.xml”)
Oppure
Dim ds As New DataSet
Dim xd As New XmlDataDocument
xd.load(“file.xml”)
ds=xd.DataSet
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

XmlNode
• Tag: elemento più semplice di un file XML
• XmlNode: unità elementare di
XmlDataDocument
• Contiene sostanzialmente un record della
tabella
• Diversi tipi di nodi
• Proprietà XmlNodeType
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

XmlNodeType (valori - 1)
• Attribute: tag attributo, può essere seguito da un
child di tipo text, non è child di nulla
• Comment: commento nel testo xml, non ha child,
può essere child di oggetti di tipo Document e
Element
• Document: identifica l’intero documento, può essere
seguito da: element, xmlDeclaration, Comment
• DocumentFragment: frammento di documenti, può
essere seguito da: element, xmlDeclaration,
Comment
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14

XmlNodeType (valori - 2)
• Element: elemento di inizio di una struttura, può
essere seguito da Element, Comment, Text
• EndElement: indica la fine di un elemento
• Text: testo contenuto in un nodo, non ha figli, può
essere figlio di Attribute, Element o
DocumentFragment
• XmlDeclaration: dichiarazione dello standard XML
usato. Primo nodo di un documento.
Inf. Med. - 15. Uso di XML con
ADO.NET - A.A. 2013/14