Condividi tramite

Procedura: aggiornare i percorsi dell'assembly manifesto dell'applicazione a livello di codice (System 2003)

  • Articolo

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 2003

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

È possibile utilizzare il modello a oggetti presente nel runtime di Visual Studio Tools per Office per aggiornare a livello di codice il manifesto dell'applicazione incorporato in un documento che fa parte di una personalizzazione a livello di documento.

Quando si modificano i percorsi degli assembly, è necessario creare un nuovo manifesto dell'applicazione e sostituire quello in cui sono presenti i percorsi precedenti. Nei percorsi degli assembly è possibile utilizzare variabili d'ambiente, come %ProgramFiles% o %UserProfile%.

Il codice per la modifica del modello a oggetti deve essere inserito in un nuovo progetto, ad esempio in un'applicazione console o un progetto Windows Form, e non nella soluzione Visual Studio Tools per Office. In Visual Studio Tools per Office è incluso un esempio in cui viene illustrato come creare uno strumento per modificare il manifesto dell'applicazione incorporato. Per ulteriori informazioni, vedere la classe Esempio ServerDocument.

È disponibile un altro modello per l'aggiornamento dei manifesti che prevede la modifica dei file XML su un server. Per ulteriori informazioni, vedere la classe Procedura: modificare la posizione delle personalizzazioni a livello di documento (System 2003).

Nota:

Questo argomento non si applica ai componenti aggiuntivi a livello di applicazione, poiché non utilizzano manifesti di applicazione incorporati. Per modificare il percorso dell'assembly di un componente aggiuntivo, utilizzare un editor di testo in modo da aggiornare il manifesto dell'applicazione presente nel computer client. Per ulteriori informazioni, vedere la classe Manifesti dell'applicazione per le soluzioni Office (System 2003). Per ulteriori informazioni sui componenti aggiuntivi a livello di applicazione e sulle personalizzazioni a livello di documento, vedere Architettura delle personalizzazioni a livello di documento.

Per modificare il percorso degli assembly a livello di codice

  1. Aggiungere un riferimento a Microsoft.VisualStudio.Tools.Office.Runtime.v9.0 al progetto di modifica del modello a oggetti se non è già presente.

  2. Aggiungere un'istruzione Imports o using per il runtime all'inizio del file di codice.

    Imports Microsoft.VisualStudio.Tools.Applications.Runtime

    using Microsoft.VisualStudio.Tools.Applications.Runtime;

  3. Chiamare il metodo statico AddCustomization della classe ServerDocument e passarlo negli argomenti richiesti. Innanzi tutto è necessario chiamare il metodo RemoveCustomization per rimuovere le eventuali personalizzazioni di Visual Studio Tools per Office dal documento; in caso contrario, AddCustomization genererà un oggetto InvalidOperationException.

    Dim solutionDocument As String = "C:\Documents\ExcelApplication.xls"
Dim assemblyName As String = "ExcelApplication.dll"
Dim manifestPath As String = "\\serversame\deployshare\ExcelApplication.application"
Dim applicationVersion As String = "1.0.0.1"

If ServerDocument.IsCustomized(solutionDocument) Then
    ServerDocument.RemoveCustomization(solutionDocument)
End If

ServerDocument.AddCustomization( _
    solutionDocument, assemblyName, manifestPath, _
    applicationVersion, False)

    string solutionDocument = @"C:\Documents\ExcelApplication.xls";
string assemblyName = "ExcelApplication.dll";
string manifestPath = @"\\servername\deployshare\ExcelApplication.application";
string applicationVersion = "1.0.0.1";

if (ServerDocument.IsCustomized(solutionDocument))
{
    ServerDocument.RemoveCustomization(solutionDocument);
}

ServerDocument.AddCustomization(
    solutionDocument, assemblyName, manifestPath, 
    applicationVersion, false);

Vedere anche

Attività

Procedura: modificare il percorso del manifesto di distribuzione a livello di codice (System 2003)

Procedura: rimuovere estensioni di codice gestito da documenti (System 2003)

Concetti

Manifesti dell'applicazione e di distribuzione nelle soluzioni di Office

Distribuzione di soluzioni Office (System 2003)

Riferimenti

Manifesti dell'applicazione per le soluzioni Office (System 2003)

Manifesti di distribuzione per le soluzioni Office (System 2003)