Gestione dei documenti di un server utilizzando la classe ServerDocument
È possibile utilizzare la classe ServerDocument in Runtime di Visual Studio Tools per Office 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 l'assembly di personalizzazione associato a un documento. Per ulteriori informazioni, vedere Gestione della personalizzazione del documento.
Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento per Excel 2007, Excel 2010, Word 2007 e Word 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.
Informazioni sulla classe ServerDocument
La classe ServerDocument è progettata per i computer in cui Office non è installato. Pertanto, in genere si utilizza questa classe nelle applicazioni che non si integrano con Office, ad esempio progetti Console o Windows Form, anziché progetti Office.
Esistono due diverse versioni della classe ServerDocument in Visual Studio 2010 Tools per Office Runtime.La scelta della versione da utilizzare dipende dalla versione di .NET Framework a cui è destinata l'applicazione in cui si intende utilizzare la classe:
Per le applicazioni destinate a .NET Framework 4, utilizzare la classe Microsoft.VisualStudio.Tools.Applications.ServerDocument nell'assembly Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll.
Per le applicazioni destinate a .NET Framework 3.5, utilizzare la classe Microsoft.VisualStudio.Tools.Applications.ServerDocument nell'assembly Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dl.
È possibile utilizzare entrambe le versioni della classe ServerDocument in personalizzazioni a livello di documento create utilizzando Visual Studio 2010 o in personalizzazioni a livello di documento per Excel 2007 e Word 2007 create tramite Visual Studio 2008.
Per ulteriori informazioni su Visual Studio 2010 Tools per Office Runtime e sulle estensioni di Office per .NET Framework, vedere Cenni preliminari su Visual Studio Tools per Office Runtime.
Nota
Se si dispone di un'applicazione legacy che utilizza la classe ServerDocument in Visual Studio Tools per Office System 3.0 Runtime, è necessario installare Visual Studio Tools per Office System 3.0 Runtime nei computer che eseguono l'applicazione. Non è possibile eseguire queste applicazioni in Visual Studio 2010 Tools per Office Runtime.
Utilizzo dei dati memorizzati nella cache in un documento
La classe ServerDocument fornisce 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à |
Membro da utilizzare |
|---|---|
Per determinare se un documento ha una cache di dati. |
Metodo IsCacheEnabled. |
Per accedere ai dati memorizzati nella cache in un documento. Per ulteriori informazioni, vedere Accesso ai dati dei documenti sul server. |
Proprietà CachedData. |
Gestione della personalizzazione del documento
È possibile utilizzare i membri della classe ServerDocument per gestire l'assembly di personalizzazione associato a 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.
Nella tabella seguente sono elencati i membri che si possono utilizzare per gestire l'assembly di personalizzazione.
Attività |
Membro da utilizzare |
|---|---|
Per determinare se un documento fa parte di una personalizzazione a livello di documento. |
Metodo GetCustomizationVersion. |
Per connettere a livello di codice una personalizzazione a un documento in fase di esecuzione. Per ulteriori informazioni, vedere Procedura: associare estensioni di codice gestito a documenti. |
Uno dei metodi AddCustomization. |
Per rimuovere a livello di codice una personalizzazione da un documento in fase di esecuzione. Per ulteriori informazioni, vedere Procedura: rimuovere estensioni di codice gestito dai documenti. |
Metodo RemoveCustomization. |
Per ottenere l'URL del manifesto di distribuzione associato al documento. |
Proprietà DeploymentManifestUrl. |
Vedere anche
Attività
Procedura: associare estensioni di codice gestito a documenti
Procedura: rimuovere estensioni di codice gestito dai documenti
Riferimenti
Microsoft.VisualStudio.Tools.Applications.ServerDocument