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 2013, Excel 2010, Word 2013 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.Utilizzare la classe Microsoft.VisualStudio.Tools.Applications.ServerDocument nell'assembly Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll.

La classe ServerDocument può essere utilizzata per l'esecuzione nelle personalizzazioni a livello di documento create utilizzando Visual Studio 2012.

Per ulteriori informazioni sugli di Visual Studio 2010 tools for 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 nel sistema di Visual Studio Tools per Office (versione runtime 3,0), il sistema di Visual Studio Tools per Office (versione runtime 3,0) deve essere installato nei computer che eseguono l'applicazione.Visual Studio 2010 tools per Office runtime non possono eseguire queste applicazioni.

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.

Task

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.

Task

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

Concetti

Cenni preliminari su Visual Studio Tools per Office Runtime

Memorizzazione di dati nella cache