Comment : récupérer des données mises en cache d'un classeur sur un serveur

Mise à jour : novembre 2007

Vous pouvez récupérer les données du cache d'un classeur Microsoft Office Excel faisant partie d'un projet Visual Studio Tools pour Office au niveau du document sans exécuter Excel. Cela permet ainsi d'obtenir des données contenues dans des classeurs Excel stockés sur un serveur.

Le code permettant de récupérer les données doit être situé en dehors de l'assembly du projet Visual Studio Tools pour Office associé au document sur lequel vous travaillez (par exemple, dans une page Web ASP.NET, une application console ou une application Windows Forms).

Pour obtenir des instructions pas à pas pour l'utilisation des exemples de code de cette rubrique, consultez Procédure pas à pas : récupération des données mises en cache d'un classeur sur un serveur.

Exemple

L'exemple de code suivant crée d'abord une instance d'un groupe de données typé nommé AdventureWorksLTDataSet. Le code utilise ensuite la propriété CachedData de la classe ServerDocument pour accéder à une instance remplie du même groupe de données typé déjà mis en cache dans un classeur Excel, puis lit les données du dataset mis en cache dans le dataset local.

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();
}

Compilation du code

L'exemple de code de cette rubrique est destiné à être utilisé avec les applications suivantes :

• Une application console qui a accès à un projet Bibliothèque de classes qui définit un groupe de données typé. Le code est exécuté dans l'application console.

• Un classeur Excel qui fait partie d'une personnalisation au niveau du document pour Excel 2003 ou Excel 2007. Le classeur possède un dataset mis en cache nommé AdventureWorksLTDataSet qui contient des données.

Pour obtenir des instructions pas à pas pour l'utilisation du code, consultez Procédure pas à pas : récupération des données mises en cache d'un classeur sur un serveur.

Voir aussi

Tâches

Procédure pas à pas : récupération des données mises en cache d'un classeur sur un serveur

Comment : mettre en cache des données pour une utilisation hors connexion ou sur un serveur

Comment : modifier les données mises en cache dans un classeur sur un serveur

Concepts

Accès aux données des documents sur le serveur

Modèle de données dans les personnalisations au niveau du document