XmlDataSource

XmlDataSource class

Fornisce l’accesso ai dati di un file XML o di un flusso da utilizzare all’interno di un report.

Per saperne di più, visita ilMotore di reporting LINQ articolo di documentazione.

public class XmlDataSource

Costruttori

NomeDescrizione
XmlDataSource(Stream)Crea una nuova origine dati con dati da un flusso XML utilizzando le opzioni predefinite per il caricamento dei dati XML.
XmlDataSource(string)Crea una nuova origine dati con dati da un file XML utilizzando le opzioni predefinite per il caricamento dei dati XML.
XmlDataSource(Stream, Stream)Crea una nuova origine dati con dati provenienti da un flusso XML utilizzando un flusso XML Schema Definition. Le opzioni predefinite vengono utilizzate per il caricamento dei dati XML.
XmlDataSource(Stream, XmlDataLoadOptions)Crea una nuova origine dati con dati da un flusso XML utilizzando le opzioni specificate per il caricamento dei dati XML.
XmlDataSource(string, string)Crea una nuova origine dati con dati da un file XML utilizzando un file XML Schema Definition. Le opzioni predefinite vengono utilizzate per il caricamento dei dati XML.
XmlDataSource(string, XmlDataLoadOptions)Crea una nuova origine dati con dati da un file XML utilizzando le opzioni specificate per il caricamento dei dati XML.
XmlDataSource(Stream, Stream, XmlDataLoadOptions)Crea una nuova origine dati con dati provenienti da un flusso XML utilizzando un flusso XML Schema Definition. Le opzioni specificate vengono utilizzate per il caricamento dei dati XML.
XmlDataSource(string, string, XmlDataLoadOptions)Crea una nuova origine dati con dati da un file XML utilizzando un file XML Schema Definition. Le opzioni specificate vengono utilizzate per il caricamento dei dati XML.

Osservazioni

Per accedere ai dati del file o del flusso corrispondente durante la generazione di un report, passare un’istanza di questa classe come una fonte dati a uno deiReportingEngine Sovraccarichi di .BuildReport.

Nei documenti modello, se un elemento XML di primo livello contiene solo un elenco di elementi dello stesso tipo, unXmlDataSource l’istanza dovrebbe essere trattata allo stesso modo come se fosse aDataTable istanza. Altrimenti, unXmlDataSource l’istanza dovrebbe essere trattata allo stesso modo come se fosse aDataRow Istanza . Per ulteriori informazioni, consultare il riferimento alla sintassi del template (https://docs.aspose.com/display/wordsnet/Template+Syntax).

Quando la definizione dello schema XML viene passata a un costruttore di questa classe, i tipi di dati dei valori degli elementi XML semplici e degli attributi vengono determinati in base allo schema. Pertanto, nei documenti modello, è possibile lavorare con valori tipizzati anziché solo stringhe.

Quando la definizione dello schema XML non viene passata a un costruttore di questa classe, i tipi di dati dei valori degli elementi XML semplici e degli attributi vengono determinati automaticamente in base alle loro rappresentazioni di stringa. Pertanto, nei documenti modello, è possibile lavorare con anche in questo caso con valori tipizzati. Il motore è in grado di riconoscere automaticamente i seguenti tipi di valori:

  • Nullable
  • Nullable
  • Nullable
  • Nullable
  • String

Si noti che affinché il riconoscimento automatico dei tipi di dati funzioni, le rappresentazioni stringa dei valori degli elementi XML semplici e degli attributi devono essere formate utilizzando impostazioni di cultura invarianti.

Per sovrascrivere il comportamento predefinito del caricamento dei dati XML, inizializzare e passare unXmlDataLoadOptions istanza a un costruttore di questa classe.

Esempi

Mostra come utilizzare XML come origine dati (stringa).

Document doc = new Document(MyDir + "Reporting engine template - XML data destination.docx");

XmlDataSource dataSource = new XmlDataSource(MyDir + "List of people.xml");
BuildReport(doc, dataSource, "persons");

doc.Save(ArtifactsDir + "ReportingEngine.XmlDataString.docx");

Mostra come utilizzare XML come sorgente dati (flusso).

Document doc = new Document(MyDir + "Reporting engine template - XML data destination.docx");

using (FileStream stream = File.OpenRead(MyDir + "List of people.xml"))
{
    XmlDataSource dataSource = new XmlDataSource(stream);
    BuildReport(doc, dataSource, "persons");
}

doc.Save(ArtifactsDir + "ReportingEngine.XmlDataStream.docx");

Guarda anche

XmlDataLoadOptions Class