Gestione dei documenti di un server utilizzando la classe ServerDocument
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
Versione Microsoft Office
Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione. |
È possibile utilizzare la classe ServerDocument per gestire molti aspetti della personalizzazione a livello di documento, anche se Microsoft Office Word e Microsoft Office Excel non sono installati. È possibile svolgere le attività indicate di seguito.
Accedere e modificare i dati nella cache di dati di un documento o di una cartella di lavoro. Per ulteriori informazioni, vedere Utilizzo dei dati memorizzati nella cache in un documento.
Gestire la personalizzazione di Visual Studio Tools per Office per un documento. Per ulteriori informazioni, vedere Gestione della personalizzazione del documento.
Informazioni sulla classe ServerDocument
Esistono due diverse versioni della classe ServerDocument, una per ogni versione del runtime Visual Studio Tools per Office. Utilizzare quella corrispondente alla versione della soluzione Microsoft Office:
Utilizzare la classe Microsoft.VisualStudio.Tools.Applications.ServerDocument con le personalizzazioni per Excel 2007 e Word 2007. Questa classe è fornita da Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime).
Utilizzare la classe Microsoft.VisualStudio.Tools.Applications.Runtime.ServerDocument con le personalizzazioni per Excel 2003 e Word 2003. Questa classe è fornita da Visual Studio 2005 Tools per Office Second Edition Runtime.
Anche se le due versioni della classe ServerDocument hanno molte funzionalità in comune, vi sono alcune differenze relativamente agli spazi dei nomi, agli assembly e ai membri. Per ulteriori informazioni, vedere Informazioni sulle differenze di ServerDocument.
La classe ServerDocument è progettata per i computer che non hanno Microsoft Office. Pertanto, in genere si utilizza questa classe nei progetti che non si integrano con Microsoft Office, ad esempio progetti Console o Windows Form, anziché progetti Visual Studio Tools per Office.
Per ulteriori informazioni sulle diverse versioni del runtime di Visual Studio Tools per Office, vedere Cenni preliminari su Visual Studio Tools per Office Runtime.
Utilizzo dei dati memorizzati nella cache in un documento
Entrambe le versioni della classe ServerDocument forniscono membri che si possono utilizzare con la cache di dati nei documenti personalizzati. Per ulteriori informazioni sui dati memorizzati nella cache, vedere Memorizzazione di dati nella cache e Accesso ai dati dei documenti sul server.
Nella tabella seguente sono elencati i membri che si possono utilizzare con i dati memorizzati nella cache.
Attività |
Progetti Excel 2007 e Word 2007 |
Progetti Excel 2003 e Word 2003 |
|---|---|---|
Per determinare se un documento ha una cache di dati Visual Studio Tools per Office. |
Il metodo IsCacheEnabled in Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime). |
Il metodo IsCacheEnabled in Visual Studio 2005 Tools per Office Second Edition Runtime. |
Per accedere ai dati memorizzati nella cache in un documento. Per ulteriori informazioni, vedere la classe Accesso ai dati dei documenti sul server. |
La proprietà CachedData in Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime). |
La proprietà CachedData in Visual Studio 2005 Tools per Office Second Edition Runtime. |
Gestione della personalizzazione del documento
È possibile utilizzare membri della classe ServerDocument per gestire la personalizzazione Visual Studio Tools per Office per un documento. Ad esempio, è possibile rimuovere a livello di codice la personalizzazione da un documento, in modo che il documento non sia più incluso in una personalizzazione Visual Studio Tools per Office.
Nella tabella seguente sono elencati i membri che si possono utilizzare per gestire l'assembly di personalizzazione.
Attività |
Progetti Excel 2007 e Word 2007 |
Progetti Excel 2003 e Word 2003 |
|---|---|---|
Per determinare se un documento ha una personalizzazione Visual Studio Tools per Office. |
Il metodo GetCustomizationVersion in Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime). |
Il metodo IsCustomized in Visual Studio 2005 Tools per Office Second Edition Runtime. |
Per connettere a livello di codice una personalizzazione a un documento in fase di esecuzione. Per ulteriori informazioni, vedere: |
Uno dei metodi AddCustomization in Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime). |
Uno dei metodi AddCustomization in Visual Studio 2005 Tools per Office Second Edition Runtime. |
Per rimuovere a livello di codice una personalizzazione da un documento in fase di esecuzione. Per ulteriori informazioni, vedere: |
Il metodo RemoveCustomization in Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime). |
Il metodo RemoveCustomization in Visual Studio 2005 Tools per Office Second Edition Runtime. |
Per ottenere l'URL del manifesto di distribuzione associato al documento. |
La proprietà DeploymentManifestUrl in Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime). |
Visual Studio 2005 Tools per Office Second Edition Runtime non include questa proprietà perché il manifesto di distribuzione è facoltativo con le soluzioni a livello di documento per Excel 2003 e Word 2003 che invece hanno sempre un manifesto dell'applicazione incorporato. |
Per accedere al manifesto dell'applicazione incorporato nel documento. |
Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime) non include questa proprietà perché le soluzioni a livello di documento per Excel 2007 e Word 2007 non hanno un manifesto dell'applicazione incorporato. |
La proprietà AppManifest in Visual Studio 2005 Tools per Office Second Edition Runtime. |
Informazioni sulle differenze di ServerDocument
Le due versioni della classe ServerDocument e le classi correlate che forniscono il modello a oggetti per i dati memorizzati nella cache (ad esempio CachedDataHostItem e CachedDataItem) sono definite in assembly e spazi dei nomi diversi. Inoltre, alcuni membri e overload di metodi sono forniti solo in una versione della classe. Tenere conto di queste differenze negli scenari seguenti:
Si desidera eseguire la migrazione del codice che utilizza la classe ServerDocument in Visual Studio 2005 Tools per Office Second Edition Runtime così da poterla utilizzare con le soluzioni Excel 2007 e Word 2007.
Si desidera utilizzare la classe ServerDocument in un codice che impiega le personalizzazioni a livello di documento per Microsoft Office 2003 e Microsoft Office System 2007.
Per un esempio che illustra l'utilizzo di entrambe le versione della classe ServerDocument nello stesso codice, vedere Procedura: scrivere codice che utilizzi entrambe le versioni della classe ServerDocument.
Differenze degli spazi dei nomi e degli assembly
Nella seguente tabella vengono elencate le differenze degli spazi dei nomi e degli assembly per le due versioni della classe ServerDocument e le classi che forniscono il modello a oggetti per i dati memorizzati nella cache.
Versione del runtime |
Spazio dei nomi |
Assembly |
|---|---|---|
Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime) |
Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll |
|
Visual Studio 2005 Tools per Office Second Edition Runtime |
Microsoft.VisualStudio.Tools.Applications.Runtime.dll |
Differenze dei membri
I membri seguenti sono forniti solo nella classe ServerDocument in Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime):
I membri seguenti sono forniti solo nella classe ServerDocument in Visual Studio 2005 Tools per Office Second Edition Runtime:
Vedere anche
Attività
Procedura: scrivere codice che utilizzi entrambe le versioni della classe ServerDocument
Procedura: associare estensioni di codice gestito a documenti (System 2007)
Procedura: associare estensioni di codice gestito a documenti (System 2003)
Procedura: rimuovere estensioni di codice gestito da documenti (System 2007)
Procedura: rimuovere estensioni di codice gestito da documenti (System 2003)
Concetti
Cenni preliminari su Visual Studio Tools per Office Runtime
Memorizzazione di dati nella cache
Riferimenti
Microsoft.VisualStudio.Tools.Applications.ServerDocument
Microsoft.VisualStudio.Tools.Applications.Runtime.ServerDocument