Condividi tramite


Modello di dati nelle personalizzazioni a livello di documento

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

  • Microsoft Office System 2007

  • Microsoft Office 2003

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

Uno degli obiettivi principali delle soluzioni Visual Studio Tools per Office a livello di documento consiste nel separare i dati dalla visualizzazione nei documenti di Office. Per dati si intendono le informazioni memorizzate nel documento, ad esempio numeri e testo. Per visualizzazione si intende l'interfaccia utente e il modello a oggetti di Microsoft Office Word e Microsoft Office Excel.

Visual Studio Tools per Office separa i dati dalla visualizzazione nelle personalizzazioni a livello di documento consentendo di incorporare i dati come un'isola di dati, anche definita cache dei dati. Tale funzionalità consente di leggere o modificare i dati direttamente senza avviare Word o Excel. Ciò risulta utile quando è necessario modificare i dati di documenti contenuti in un server in cui non è stato installato Microsoft Office. Word ed Excel sono destinati all'utilizzo in ambienti client; non sono progettati per essere eseguiti in un server.

Per ulteriori informazioni sulle personalizzazioni a livello di documento, vedere Cenni preliminari sullo sviluppo di soluzioni Office e Architettura delle personalizzazioni a livello di documento.

Informazioni sul modello di programmazione dei dati memorizzati nella cache

L'isola di dati può contenere qualsiasi oggetto della soluzione, purché soddisfi determinati requisiti. Alcuni esempi di oggetti che è possibile includere in un'isola di dati sono gli oggetti DataSet, gli oggetti DataTable e qualsiasi altro oggetto serializzabile mediante la classe XmlSerializer. Per ulteriori informazioni, vedere Memorizzazione di dati nella cache.

Per fornire la visualizzazione dei dati memorizzati nella cache è possibile associare controlli Windows Form e controlli host contenuti nel documento a oggetti contenuti nell'isola di dati. Questa associazione dati consente di garantire la sincronizzazione tra l'isola di dati e i controlli associati ai dati. È inoltre possibile aggiungere ai dati codice di convalida indipendente dai controlli. Per ulteriori informazioni, vedere Associazione di dati ai controlli.

I controlli host sono versioni estese di oggetti nativi appartenenti ai modelli a oggetti di Excel e Word. A differenza degli oggetti nativi, i controlli host possono essere associati direttamente agli oggetti dati gestiti. Per ulteriori informazioni, vedere°Cenni preliminari sugli elementi e sui controlli host e Cenni preliminari sui controlli Windows Form nei documenti di Office.

Accesso ai dati memorizzati nella cache sul server

Per accedere ai dati di un documento memorizzati nella cache è possibile utilizzare la classe ServerDocument. Questa classe appartiene al runtime di Visual Studio Tools per Office e può essere utilizzata in un server senza eseguire Excel o Word. Quando un utente apre un documento i cui dati memorizzati nella cache sono stati modificati, tutti i controlli associati ai dati vengono sincronizzati automaticamente con la cache. Pertanto, l'utente sarà in grado di accedere a una versione aggiornata del documento. Per ulteriori informazioni, vedere la classe Accesso ai dati dei documenti sul server.

Excel e Word non vengono utilizzati per scrivere nei dati sul server, ma solo per visualizzarli sul client. Queste due applicazioni possono anche non essere installate sul server. Ciò consente di migliorare la scalabilità nonché di velocizzare l'elaborazione batch dei documenti che contengono isole di dati.

Memorizzazione di dati nella cache per l'utilizzo non in linea

La memorizzazione dei dati nell'isola di dati offre la possibilità di accedere a scenari non in linea. Quando un utente apre per la prima volta un documento o lo richiede al server, l'isola di dati contiene i dati più recenti. L'isola di dati viene memorizzata nella cache del documento ed è quindi disponibile per l'utilizzo non in linea. I dati possono essere modificati dall'utente o tramite codice, anche senza una connessione attiva. Alla riconnessione successiva, le modifiche apportate ai dati possono essere propagate a un'origine dati su server.

Confronto fra dati memorizzati nella cache e web part XML personalizzate

Le web part XML personalizzate sono state introdotte in Microsoft Office System 2007 per consentire la memorizzazione di elementi XML arbitrari in un documento. Benché gli scenari in cui le web part XML personalizzate risultano utili corrispondano agli scenari in cui conviene utilizzare una cache dei dati, esistono alcune differenze tra l'isola di dati di Visual Studio Tools per Office e le web part XML personalizzate. Per ulteriori informazioni sulle web part XML personalizzate, vedere Cenni preliminari sulle web part XML personalizzate.

Nella tabella seguente sono elencati alcuni punti in comune nonché alcune differenze fra l'isola di dati e le web part XML personalizzate.

Cache di dati

Web part XML personalizzate

Applicazioni di Office in grado di utilizzare la cache di dati o le web part XML personalizzate

Personalizzazioni a livello di documento per le applicazioni seguenti:

  • Excel 2007

  • Excel 2003

  • Word 2007

  • Word 2003

Soluzioni a livello di documento e soluzioni a livello di applicazione per le applicazioni seguenti:

  • Excel 2007

  • PowerPoint 2007

  • Word 2007

Tipi di dati memorizzabili

Qualsiasi oggetto pubblico contenuto nell'assembly di personalizzazione che soddisfi determinati requisiti. Per ulteriori informazioni, vedere la classe Memorizzazione di dati nella cache.

Qualsiasi tipo di dati XML.

Accesso ai dati senza avviare le applicazioni di Microsoft Office

Mediante la classe ServerDocument fornita dal runtime di Visual Studio Tools per Office.

Mediante le classi dello spazio dei nomi System.IO.Packaging, a partire da .NET Framework 3.0.

Vedere anche

Altre risorse

Dati nelle soluzioni Office

Architettura di soluzioni Visual Studio Tools per Office