Procedura: associare estensioni di codice gestito a documenti (System 2003)

Articolo
04/28/2010

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.

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 associare l'assembly di una soluzione Visual Studio Tools per Office a un documento di Microsoft Office Word 2003 o a una cartella di lavoro di Microsoft Office Excel 2003 esistente. Il documento o la cartella di lavoro può essere in qualsiasi formato di file supportato in Visual Studio Tools per Office. Per ulteriori informazioni, vedere la classe Architettura delle personalizzazioni a livello di documento.

Se si associa l'assembly di una soluzione a un documento per cui non sono ancora disponibili personalizzazioni di Visual Studio Tools per Office, il runtime di Visual Studio Tools per Office crea automaticamente un controllo Runtime Storage nel documento. Per ulteriori informazioni, vedere Cenni preliminari sul controllo Runtime Storage.

Nota:
Se il documento specificato non include un controllo previsto dall'assembly della soluzione, l'assembly non verrà caricato all'apertura del documento da parte dell'utente.

Per associare l'assembly di una soluzione a un documento è possibile procedere in due modi:

Impostare manualmente proprietà personalizzate nel documento stesso.
Associare a livello di codice l'assembly utilizzando la classe ServerDocument.

Utilizzo di proprietà personalizzate per il documento

Per associare l'assembly di una soluzione Visual Studio Tools per Office a un documento di Word o di Excel è possibile impostare manualmente le proprietà personalizzate _AssemblyName e _AssemblyLocation del documento. Per ulteriori informazioni, vedere Cenni preliminari sulle proprietà personalizzate dei documenti.

Nella procedura riportata di seguito si presuppone che l'assembly della soluzione sia già stato distribuito e che la soluzione utilizzi un manifesto di distribuzione. Per ulteriori informazioni, vedere la classe Distribuzione delle personalizzazioni a livello di documento (2003 System).

Per associare l'assembly di una soluzione impostando proprietà personalizzate per il documento

Aprire il documento in Word o in Excel.
Scegliere Proprietà dal menu File, quindi fare clic sulla scheda Personalizza.
Impostare la proprietà _AssemblyName:
1. Se la proprietà _AssemblyName è visualizzata nell'elenco Proprietà, selezionare _AssemblyName, quindi digitare un asterisco (*) nella casella Valore.
2. Se invece la proprietà _AssemblyName non è visualizzata nell'elenco, digitare _AssemblyName nella casella Nome, digitare un asterisco (*) nella casella Valore, quindi scegliere Aggiungi.

Impostare la proprietà _AssemblyLocation:

Se la proprietà _AssemblyLocation è visualizzata nell'elenco Proprietà, selezionare _AssemblyLocation, quindi digitare il percorso completo del manifesto di distribuzione nella casella Valore.
Se invece la proprietà _AssemblyLocation non è visualizzata nell'elenco, digitare _AssemblyLocation nella casella Nome, digitare il percorso completo del manifesto di distribuzione nella casella Valore e quindi scegliere Aggiungi.

Il percorso del manifesto di distribuzione può essere un percorso su disco (C:\distribuzione\Documento1.applicazione), una condivisione file (\\server\Documento1.applicazione) o un sito Web (https://www.contoso.com/Documento1.applicazione).

Nota:
Il valore di una proprietà personalizzata del documento può contenere 255 caratteri. Se la lunghezza del percorso del manifesto supera i 255 caratteri, creare una proprietà denominata _AssemblyLocation0 e impostarla sui primi 255 caratteri del percorso. Creare quindi una proprietà denominata _AssemblyLocation1 e impostarla sui restanti caratteri del percorso del manifesto.

Scegliere OK, quindi salvare e chiudere il documento.

Quando il documento viene riaperto e salvato, il runtime di Visual Studio Tools per Office associa l'assembly della soluzione al documento e, se necessario, crea il controllo Runtime Storage. Inoltre, il runtime di Visual Studio Tools per Office imposta il valore della proprietà personalizzata _AssemblyLocation del documento sul GUID del controllo Runtime Storage. Per ulteriori informazioni, vedere Cenni preliminari sul controllo Runtime Storage.

Nota:
Il documento deve essere aperto e salvato in un computer in cui sia installato il runtime di Visual Studio Tools per Office. Per ulteriori informazioni, vedere Procedura: installare il runtime di Microsoft Visual Studio Tools per Office.

Utilizzo della classe ServerDocument

È possibile associare l'assembly di una soluzione Visual Studio Tools per Office a un documento di Word o di Excel utilizzando il metodo AddCustomization della classe ServerDocument. Il codice che utilizza la classe ServerDocument deve essere inserito in un nuovo progetto, ad esempio in un progetto Windows Form, e non nella soluzione Visual Studio Tools per Office. Il documento a cui si desidera associare l'assembly inoltre deve essere chiuso e deve trovarsi in un computer in cui sia installato Word nel caso di documenti di Word o Excel nel caso di cartelle di lavoro di Excel.

Per associare l'assembly di una soluzione a un documento utilizzando la classe ServerDocument

Creare un nuovo progetto Windows Form.
Aggiungere un riferimento all'assembly Microsoft.VisualStudio.Tools.Applications.Runtime.dll nel progetto.

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;

Chiamare il metodo AddCustomization statico della classe ServerDocument e specificare il percorso del documento della soluzione, il nome dell'assembly e il percorso del manifesto di distribuzione nei parametri. Nel codice riportato di seguito si presuppone che venga associato un assembly a un documento di Word denominato WordDocument1.doc contenuto nella cartella C:\WordDocument1 e che il manifesto e l'assembly di distribuzione siano contenuti nella condivisione di rete \\deployserver\WordDocument1\.

Private Sub AddNewCustomization()

    Dim fileName As String = "C:\WordDocument1\WordDocument1.doc"

    If Not ServerDocument.IsCustomized(fileName) Then

        Dim assemblyName As String = "\\deployserver\WordDocument1\WordDocument1.dll"
        Dim manifestPath As String = "\\deployserver\WordDocument1\WordDocument1.application"
        Dim applicationVersion As String = "1.0.0.0"

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

    Else
        System.Windows.Forms.MessageBox.Show( _
            "The specified document is already customized.")
    End If
End Sub

private void AddNewCustomization()
{
    string fileName = @"C:\WordDocument1\WordDocument1.doc";

    if (!ServerDocument.IsCustomized(fileName))
    {
        string assemblyName = @"\\deployserver\WordDocument1\WordDocument1.dll";
        string manifestPath = @"\\deployserver\WordDocument1\WordDocument1.application";
        string applicationVersion = "1.0.0.0";

        ServerDocument.AddCustomization(
            fileName, assemblyName, manifestPath, applicationVersion, false);
    }
    else
    {
        System.Windows.Forms.MessageBox.Show(
            "The specified document is already customized.");
    }
}

Il runtime di Visual Studio Tools per Office associa l'assembly della soluzione al documento e, se necessario, crea un controllo Runtime Storage. Per ulteriori informazioni, vedere Cenni preliminari sul controllo Runtime Storage.