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

Articolo
09/12/2008

Aggiornamento: novembre 2007

Nota	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. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazione.	Tipo di progetto Progetti a livello di documento Progetti a livello di applicazione Versione Microsoft Office Microsoft Office 2003

Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati.

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

Tipo di progetto

Progetti a livello di documento
Progetti a livello di applicazione

Versione Microsoft Office

Microsoft Office 2003

Un manifesto dell'applicazione in una soluzione Visual Studio Tools per Office è un file XML in cui sono illustrati gli assembly caricati in una soluzione Microsoft Office 2003. Nelle personalizzazioni a livello di documento, una copia del manifesto dell'applicazione è incorporata nel documento della soluzione, mentre un'altra copia viene conservata sul server di distribuzione al fine di rendere più semplice l'aggiornamento della soluzione. Nei componenti aggiuntivi a livello di applicazione, una copia del manifesto dell'applicazione è situata nel computer client, mentre un'altra copia viene conservata sul server di distribuzione al fine di rendere più semplice l'aggiornamento della soluzione. Per ulteriori informazioni, vedere Distribuzione delle personalizzazioni a livello di documento (2003 System) e Distribuzione di componenti aggiuntivi a livello di applicazione (System 2003).

In Visual Studio Tools per Office viene utilizzato uno schema di manifesto dell'applicazione simile allo schema definito per ClickOnce. Solo gli elementi e gli attributi elencati in questa tabella sono supportati per le soluzioni Visual Studio Tools per Office. Gli elementi e gli attributi che fanno parte dello schema ClickOnce, ma che non sono elencati nella tabella, vengono ignorati senza che questo comporti la generazione di un errore.

I manifesti di applicazione dispongono degli elementi e degli attributi riportati di seguito.

Elemento	Descrizione	Attributi
Elemento <assembly> (Riferimento Visual Studio Tools per Office Application)	Obbligatorio. Elemento di primo livello.	manifestVersion
Elemento <assemblyIdentity> (Riferimento Visual Studio Tools per Office)	Obbligatorio. Identifica la versione del manifesto di applicazione e descrive gli assembly dipendenti.	name version publicKeyToken language
Elemento <entryPoint> (Riferimento Visual Studio Tools per Office)	Obbligatorio. Identifica il punto di ingresso del codice dell'applicazione per l'esecuzione.	name dependencyName
Elemento <dependency> (Riferimento Visual Studio Tools per Office)	Obbligatorio. Identifica ciascuna dipendenza richiesta per l'esecuzione dell'applicazione. Può anche identificare gli assembly che è necessario preinstallare.	name
Elemento <dependentAssembly> (Riferimento Visual Studio Tools per Office)	Obbligatorio. Fornisce informazioni sugli assembly dipendenti.	Nessuno
Elemento <installFrom> (Riferimenti a Visual Studio Tools per Office)	Obbligatorio. Fornisce un percorso della distribuzione degli assembly dipendenti quando sono utilizzati come elementi figlio di un elemento dependency e del manifesto di distribuzione quando è utilizzato come elemento figlio dell'elemento assembly.	codebase
Elemento <clrClassInvocation> (riferimento a Visual Studio Tools per Office)	Obbligatorio. Indica la classe da richiamare per un elemento entryPoint.	class

Note

Il nome del server all'interno del percorso degli assembly deve essere scritto in minuscolo; in caso contrario, gli assembly non verranno memorizzati nella cache.

Ogni volta che si compila un progetto Visual Studio Tools per Office, un manifesto dell'applicazione viene generato e incorporato nel documento (per le personalizzazioni a livello di documento) o inserito nella cartella dell'output di compilazione (per i componenti aggiuntivi a livello di applicazione). Quando si pubblica una soluzione tramite la Pubblicazione guidata, nella cartella di output viene creata una copia del manifesto dell'applicazione, che a sua volta viene copiata nella destinazione di pubblicazione. Il manifesto dell'applicazione viene generato dall'attività GenerateAndPersistAppInfoTask di Visual Studio Tools per Office, non dall'attività GenerateApplicationManifest di MSBuild.

Un manifesto di applicazione è specifico per una singola versione di una soluzione distribuita. Per questo motivo, i manifesti di applicazione devono essere memorizzati separatamente da quelli di distribuzione. Di solito, il manifesto dell'applicazione viene inserito in una sottodirectory denominata in base alla versione associata. Per ulteriori informazioni, vedere Distribuzione delle personalizzazioni a livello di documento (2003 System) e Distribuzione di componenti aggiuntivi a livello di applicazione (System 2003).

A differenza dei manifesti ClickOnce, i manifesti dell'applicazione e quelli di distribuzione nelle soluzioni Visual Studio Tools per Office non sono firmati. I manifesti non possono essere convalidati prima del loro utilizzo.

Alcuni dei campi presenti nei manifesti dell'applicazione e di distribuzione generati tramite gli strumenti di pubblicazione non vengono utilizzati nelle soluzioni Visual Studio Tools per Office, inclusi alcuni campi che identificano proprietà dell'assembly come le dimensioni e la versione.

Sintassi del nome file

Il nome di un manifesto di applicazione deve essere composto dal nome dell'applicazione identificato nell'elemento assemblyIdentity, seguito dall'estensione MANIFEST. Un manifesto di applicazione che faccia riferimento, ad esempio, alla soluzione ExcelApplication1 sarà dotato del nome file riportato di seguito.

excelapplication1.manifest

Esempio

Nell'esempio di codice seguente viene illustrato un manifesto dell'applicazione relativo a una soluzione Visual Studio Tools per Office.

<?xml version="1.0" encoding="utf-8"?>
<assembly manifestVersion="1.0" 
    xmlns:asmv2="urn:schemas-microsoft-com:asm.v2"
    xmlns="urn:schemas-microsoft-com:asm.v1"
    xmlns:asm.v2="urn:schemas-microsoft-com:asm.v2"
    xmlns:ds="http://www.w3.org/2000/09/xmldsig#"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation=
       "urn:schemas-microsoft-com:asm.v1 manifest.2.0.0.9.adaptive.xsd"
>

    <assemblyIdentity name="Project1.manifest" 
        version="1.0.1.1"/>
    <asm.v2:entryPoint name="Startup" dependencyName="Project1">
        <asm.v2:clrClassInvocation class="Sheet1"/>
    </asm.v2:entryPoint>
    <asm.v2:entryPoint name="Startup" dependencyName="Project1">
        <asm.v2:clrClassInvocation class="Sheet2"/>
    </asm.v2:entryPoint>
    <asm.v2:entryPoint name="Startup" dependencyName="Project1">
        <asm.v2:clrClassInvocation class="Sheet3"/>
    </asm.v2:entryPoint>
    <dependency asmv2:name="Project1">
        <dependentAssembly>
            <assemblyIdentity name="Project1" 
                version="1.0.1.1"/>
        </dependentAssembly>
        <asmv2:installFrom codebase=
            "http://deployweb/project1/project1_1.0.1.1/project1.dll"/>
    </dependency>
    <asm.v2:installFrom codebase=
        "http://deployweb/project1/project1.application"/>
</assembly>

Vedere anche

Condividi tramite

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

Note

Sintassi del nome file

Esempio

Vedere anche

Attività

Concetti

Riferimenti

Risorse aggiuntive