Condividi tramite


Procedura: recuperare i dati memorizzati nella cache di una cartella di lavoro di un server

Aggiornamento: novembre 2007

Si applica a

Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati.

Tipo di progetto

  • Progetti a livello di documento

Versione Microsoft Office

  • Excel 2007

  • Excel 2003

Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

È possibile recuperare i dati memorizzati nella cache di una cartella di lavoro di Microsoft Office Excel che fa parte di un progetto Visual Studio Tools per Office a livello di documento senza eseguire Excel. In questo modo è possibile ottenere dati dalle cartelle di lavoro di Excel memorizzate su un server.

Il codice per il recupero dei dati deve trovarsi all'esterno dell'assembly del progetto Visual Studio Tools per Office associato al documento che si sta utilizzando, ad esempio in una pagina Web ASP.NET, un'applicazione console o un'applicazione Windows Form.

Per ottenere istruzioni dettagliate sull'utilizzo dell'esempio di codice contenuto in questo argomento, vedere Procedura dettagliata: recupero dei dati memorizzati nella cache di una cartella di lavoro di un server.

Esempio

Nell'esempio di codice seguente viene anzitutto creata un'istanza di un dataset tipizzato denominato AdventureWorksLTDataSet. Quindi, dopo aver utilizzato la proprietà CachedData della classe ServerDocument per accedere a un'istanza popolata dello stesso dataset tipizzato già memorizzato nella cache di una cartella di lavoro di Excel, il codice legge i dati contenuti nel dataset memorizzato nella cache e li inserisce nel dataset locale.

Dim productDataSet As New AdventureWorksDataSet.AdventureWorksLTDataSet()
Dim workbookPath As String = System.Environment.GetFolderPath( _
    Environment.SpecialFolder.MyDocuments) & _
    "\AdventureWorksReport\bin\Debug\AdventureWorksReport.xlsx"
Dim serverDocument1 As ServerDocument = Nothing

Try
    serverDocument1 = New ServerDocument(workbookPath)
    Dim dataHostItem1 As CachedDataHostItem = _
        serverDocument1.CachedData.HostItems("AdventureWorksReport.Sheet1")
    Dim dataItem1 As CachedDataItem = dataHostItem1.CachedData("AdventureWorksLTDataSet")

    If dataItem1 IsNot Nothing Then
        Console.WriteLine("Before reading data from the cache dataset, the local dataset has " & _
            "{0} rows.", productDataSet.Product.Rows.Count.ToString())

        ' Read the cached data from the worksheet dataset into the local dataset.
        Dim schemaReader As New System.IO.StringReader(dataItem1.Schema)
        Dim xmlReader As New System.IO.StringReader(dataItem1.Xml)
        productDataSet.ReadXmlSchema(schemaReader)
        productDataSet.ReadXml(xmlReader)

        Console.WriteLine("After reading data from the cache dataset, the local dataset has " & _
            "{0} rows.", productDataSet.Product.Rows.Count.ToString())
    Else
        Console.WriteLine("The data object is not found in the data cache.")
    End If
Catch ex As System.IO.FileNotFoundException
    Console.WriteLine("The specified workbook does not exist.")
Catch ex As System.Xml.XmlException
    Console.WriteLine("The data object has invalid XML information.")
Finally
    If Not (serverDocument1 Is Nothing) Then
        serverDocument1.Close()
    End If
    Console.WriteLine(vbLf & vbLf & "Press Enter to close the application.")
    Console.ReadLine()
End Try
AdventureWorksDataSet.AdventureWorksLTDataSet productDataSet =
    new AdventureWorksDataSet.AdventureWorksLTDataSet();
string workbookPath = System.Environment.GetFolderPath(
    Environment.SpecialFolder.MyDocuments) +
    @"\AdventureWorksReport\bin\Debug\AdventureWorksReport.xlsx";
ServerDocument serverDocument1 = null;

try
{
    serverDocument1 = new ServerDocument(workbookPath);
    CachedDataHostItem dataHostItem1 =
        serverDocument1.CachedData.HostItems["AdventureWorksReport.Sheet1"];
    CachedDataItem dataItem1 = dataHostItem1.CachedData["adventureWorksLTDataSet"];

    if (dataItem1 != null)
    {
        Console.WriteLine("Before reading data from the cache dataset, the local dataset has " +
            "{0} rows.", productDataSet.Product.Rows.Count.ToString());

        // Read the cached data from the worksheet dataset into the local dataset.
        System.IO.StringReader schemaReader = new System.IO.StringReader(dataItem1.Schema);
        System.IO.StringReader xmlReader = new System.IO.StringReader(dataItem1.Xml);
        productDataSet.ReadXmlSchema(schemaReader);
        productDataSet.ReadXml(xmlReader);

        Console.WriteLine("After reading data from the cache dataset, the local dataset has " +
            "{0} rows.", productDataSet.Product.Rows.Count.ToString());
    }
    else
    {
        Console.WriteLine("The data object is not found in the data cache.");
    }
}
catch (System.IO.FileNotFoundException)
{
    Console.WriteLine("The specified workbook does not exist.");
}
catch (System.Xml.XmlException)
{
    Console.WriteLine("The data object has invalid XML information.");
}
finally
{
    if (serverDocument1 != null)
    {
        serverDocument1.Close();
    }

    Console.WriteLine("\n\nPress Enter to close the application.");
    Console.ReadLine();
}

Compilazione del codice

L'esempio di codice contenuto in questo argomento è progettato per essere utilizzato con le applicazioni seguenti:

  • Un'applicazione console in grado di accedere a un progetto Libreria di classi che definisce un dataset tipizzato. Il codice viene eseguito nell'applicazione console.

  • Una cartella di lavoro di Excel appartenente a una personalizzazione a livello di documento per Excel 2003 o Excel 2007. La cartella di lavoro dispone di un dataset memorizzato nella cache denominato AdventureWorksLTDataSet che contiene dati.

Per ottenere istruzioni dettagliate sull'utilizzo del codice, vedere Procedura dettagliata: recupero dei dati memorizzati nella cache di una cartella di lavoro di un server.

Vedere anche

Attività

Procedura dettagliata: recupero dei dati memorizzati nella cache di una cartella di lavoro di un server

Procedura: memorizzare dati nella cache per l'utilizzo non in linea o su un server

Procedura: modificare i dati memorizzati nella cache di una cartella di lavoro di un server

Concetti

Accesso ai dati dei documenti sul server

Modello di dati nelle personalizzazioni a livello di documento