Procedura: inserire dati in una cartella di lavoro sul server

Articolo
08/11/2011

È possibile inserire dati nella cache di una cartella di lavoro di Microsoft Office Excel che fa parte di un progetto di Office a livello di documento senza eseguire Excel consentendo in tal modo l'inserimento di dati nelle cartelle di lavoro di Excel memorizzate su un server.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento per Excel 2007 ed Excel 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Il codice per l'inserimento dei dati deve trovarsi all'esterno dell'assembly del progetto associato al documento che si sta utilizzando, ad esempio in un'applicazione console o Windows Form.

Per ottenere istruzioni dettagliate sull'utilizzo dell'esempio di codice contenuto in questo argomento, vedere Procedura dettagliata: inserimento di dati in una cartella di lavoro contenuta in un server.

Esempio

Nell'esempio di codice seguente viene anzitutto creata un'istanza di un dataset tipizzato denominata AdventureWorksLTDataSet. Quindi, dopo aver passato la tabella Product nel dataset tramite un adattatore di tabelle, il codice utilizza la classe ServerDocument per accedere a un'istanza dello stesso dataset tipizzato memorizzata nella cache di una cartella di lavoro di Excel. Infine, mediante il metodo SerializeDataInstance, i dati vengono letti dal dataset locale e quindi scritti nel dataset memorizzato nella cache.

Dim productDataSet As New AdventureWorksDataSet.AdventureWorksLTDataSet()
Dim productTableAdapter As _
    New AdventureWorksDataSet.AdventureWorksLTDataSetTableAdapters.ProductTableAdapter()

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

Try
    productTableAdapter.Fill(productDataSet.Product)
    Console.WriteLine("The local dataset is filled.")

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

    ' Initialize the worksheet dataset with the local dataset.
    If dataItem1 IsNot Nothing Then
        dataItem1.SerializeDataInstance(productDataSet)
        serverDocument1.Save()
        Console.WriteLine("The data is saved to the data cache.")
    Else
        Console.WriteLine("The data object is not found in the data cache.")
    End If
Catch ex As System.Data.SqlClient.SqlException
    Console.WriteLine(ex.Message)
Catch ex As System.IO.FileNotFoundException
    Console.WriteLine("The specified workbook does not exist.")
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();
AdventureWorksDataSet.AdventureWorksLTDataSetTableAdapters.ProductTableAdapter productTableAdapter =
    new AdventureWorksDataSet.AdventureWorksLTDataSetTableAdapters.ProductTableAdapter();

string workbookPath = System.Environment.GetFolderPath(
    Environment.SpecialFolder.MyDocuments) +
    @"\AdventureWorksReport\bin\Debug\AdventureWorksReport.xlsx";
ServerDocument serverDocument1 = null;

try
{
    productTableAdapter.Fill(productDataSet.Product);
    Console.WriteLine("The local dataset is filled.");

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

    // Initialize the worksheet dataset with the local dataset.
    if (dataItem1 != null)
    {
        dataItem1.SerializeDataInstance(productDataSet);
        serverDocument1.Save();
        Console.WriteLine("The data is saved to the data cache.");
        Console.ReadLine();
    }
    else
    {
        Console.WriteLine("The data object is not found in the data cache.");
    }
}
catch (System.Data.SqlClient.SqlException ex)
{
    Console.WriteLine(ex.Message);
}
catch (System.IO.FileNotFoundException)
{
    Console.WriteLine("The specified workbook does not exist.");
}
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.
Cartella di lavoro di Excel che fa parate di una personalizzazione a livello di documento di Excel. La cartella di lavoro dispone di un dataset memorizzato nella cache denominato AdventureWorksLTDataSet contenente alcuni dati.

Per ottenere istruzioni dettagliate sull'utilizzo del codice, vedere Procedura dettagliata: inserimento di dati in una cartella di lavoro contenuta in un server.