Recupero di dati tramite XmlReader

La classe XmlReader, che fa parte dello spazio dei nomi System.Xml per la libreria di classi microsoft .NET Framework, AdomdDataReader è simile alla classe in quanto la classe XmlReader fornisce anche un accesso rapido, non memorizzato nella cache e forward-only ai dati. Se non è necessaria una visualizzazione analitica in memoria CellSet dei dati che usano l'oggetto , l'oggetto XmlReader è ideale per il recupero di dati XML, in particolare per grandi quantità di dati. Poiché XmlReader esegue il flusso dei dati, XmlReader non deve recuperare e memorizzare nella cache tutti i dati prima di esporre i dati al chiamante, CellSet come nel caso in cui fosse usato un oggetto per convertire la risposta XML for Analysis in una rappresentazione del modello a oggetti analitico.

La classe XmlReader fornisce l'accesso diretto XML for Analysis risposta ricevuta ADOMD.NET quando ExecuteXmlReader viene chiamato AdomdCommand il metodo dell'oggetto. Poiché i dati recuperati sono rappresentati da codice XML non elaborato, è necessario analizzare manualmente i dati e i metadati. Non appena i dati sono stati recuperati, l'oggetto XmlReader deve essere chiuso.

Recupero di dati e metadati

Per usare la classe XmlReader per recuperare i dati, seguire questa procedura:

1. Creare una nuova istanza dell'oggetto.

   Per creare una nuova istanza della classe XmlReader , chiamare il Execute metodo o ExecuteXmlReader dell'oggetto AdomdCommand .

2. Recuperare i dati.

   Dopo che il comando esegue la query e restituisce un XmlReader, è necessario analizzare i dati e i metadati. I dati e i metadati XML vengono presentati nel formato nativo utilizzato dal provider di XML for Analysis. Per la maggior XML for Analysis, il formato nativo è il formato MDDataSet . Il formato MDDataSet fornisce sia dati che metadati per i set di celle in un formato ben strutturato. Per altre informazioni sul formato MDDataSet , vedere la specifica XML for Analysis.

3. Chiudere il lettore.

   È necessario chiamare sempre il Close metodo al termine dell'uso dell'oggetto XmlReader . Mentre un XmlReader è aperto, XmlReader usa AdomdConnection in modo esclusivo l'oggetto usato per eseguire il comando. <Non sarà possibile eseguire comandi usando tale oggetto 'xref:Microsoft.AnalysisServices.AdomdClient.AdomdConnection>, inclusa la creazione di un altro XmlReader o AdomdDataReader, fino a quando non si chiude l'xmlreader originale.

Esempio di recupero di dati tramite XmlReader

L'esempio seguente esegue un comando e recupera i dati come XmlReader, generando il contenuto del file nella console.

        void OutputDataWithXML()
        {
            //Open a connection to the local server.
            AdomdConnection conn = new AdomdConnection("Data Source=localhost");
            conn.Open();

            //Create a command to retrieve the data.
            AdomdCommand cmd = new AdomdCommand(@"WITH MEMBER [Measures].[FreightCostPerOrder] AS 
[Measures].[Reseller Freight Cost]/[Measures].[Reseller Order Quantity],  
FORMAT_STRING = 'Currency'

SELECT [Geography].[Geography].[Country].&[United States].Children ON ROWS, 
[Date].[Calendar].[Calendar Year] ON COLUMNS
FROM [Adventure Works]
WHERE [Measures].[FreightCostPerOrder]", conn);

            //Execute the command, retrieving an XmlReader.
            System.Xml.XmlReader reader = cmd.ExecuteXmlReader();

            //Do something with the reader: Parse data, Parse metadata,
            //                              Save for later loading into CellSet, etc.
            Console.WriteLine(reader.ReadOuterXml());

            //Close the reader, then the connection
            reader.Close();
            conn.Close();

            //Await user input.
            Console.ReadLine();
        }