Manifesti di applicazione per le soluzioni Office
Un manifesto di applicazione è un file XML che descrive gli assembly caricati in una soluzione Microsoft Office.Gli strumenti di sviluppo di Microsoft Office in Visual Studio utilizzano lo schema del manifesto di applicazione ClickOnce definito nel riferimento Manifesto dell'applicazione ClickOnce.
I manifesti di applicazione delle soluzioni Office utilizzano gli elementi e gli attributi ClickOnce seguenti.
Elemento |
Descrizione |
Attributi |
|---|---|---|
Obbligatorio.Elemento di primo livello. |
manifestVersion |
|
Obbligatorio.Identifica l'assembly primario dell'applicazione ClickOnce. |
name version publicKeyToken processorArchitecture language |
|
Identifica i requisiti di sicurezza dell'applicazione. |
Nessuno |
|
Obbligatorio.Identifica il punto di ingresso del codice dell'applicazione per l'esecuzione. |
name dependencyName customHostSpecified |
|
Obbligatorio.Identifica ciascuna dipendenza richiesta per l'esecuzione dell'applicazione.Può anche identificare gli assembly che è necessario preinstallare. |
Nessuno |
|
Obbligatorio.Identifica ciascun file non di assembly utilizzato dall'applicazione.Può includere i dati sull'isolamento COM (Component Object Model) associati al file. |
name size |
I manifesti di applicazione delle soluzioni Office presentano l'elemento seguente nello spazio dei nomi co.v1.
<entryPoint>
<co.v1:customHostSpecified />
</entryPoint>
Questi manifesti di applicazione presentano inoltre gli elementi e gli attributi seguenti nello spazio dei nomi vstav3.
<addIn>
<entryPointsCollection>
<entryPoints>
<entryPoint>
</entryPoint>
</entryPoints>
</entryPointsCollection>
<update></update>
<postActions>
<postAction>
<postActionData>
</postActionData>
<postAction>
</postActions>
<application>
<customizations>
<customization>
</customization>
</customizations>
</application
</addIn>
Elemento |
Descrizione |
Attributi |
|---|---|---|
Elemento <customHostSpecified> (sviluppo per Office in Visual Studio) |
Obbligatorio.Contrassegna specificatamente il manifesto come soluzione Office. |
Nessuno |
Obbligatorio.Archivia i punti di ingresso in un solo spazio dei nomi. |
Nessuno |
|
Elemento <entryPointsCollection> (sviluppo per Office in Visual Studio) |
Obbligatorio.Raggruppa tutti gli assembly di una o più soluzioni Office. |
id |
Elemento <entryPoints> (sviluppo per Office in Visual Studio) |
Obbligatorio.Raggruppa tutti gli assembly da eseguire in una soluzione Office. |
Nessuno |
Elemento <entryPoint> (sviluppo per Office in Visual Studio) |
Obbligatorio.Identifica l'assembly da eseguire in una soluzione Office. |
class contract |
Obbligatorio.Configura gli aggiornamenti per la soluzione. |
enabled expiration |
|
Elemento <postActions> (sviluppo per Office in Visual Studio) |
Parametro facoltativo.Raggruppa tutte le azioni post-distribuzione, ovvero azioni che vengono eseguite dopo l'installazione di soluzioni Office. |
Nessuno |
Elemento <postAction> (sviluppo per Office in Visual Studio) |
Parametro facoltativo.Identifica un'azione post-distribuzione. |
Nessuno |
Elemento <postActionData> (sviluppo per Office in Visual Studio) |
Parametro facoltativo.Configura i dati di un'azione post-distribuzione. |
Nessuno |
Elemento <application> (sviluppo per Office in Visual Studio) |
Obbligatorio.Esegue il wrapping delle informazioni specifiche dell'applicazione in un solo nodo. |
Nessuno |
Elemento <customizations> (sviluppo per Office in Visual Studio) |
Obbligatorio.Archivia le informazioni host specifiche di tutte le applicazioni in un spazio dei nomi separato. |
Nessuno |
Elemento <customization> (sviluppo per Office in Visual Studio) |
Obbligatorio.Archivia le informazioni host specifiche dell'applicazione in un spazio dei nomi separato. |
xmlns |
Obbligorio solo per soluzioni a livello di documento.Archivia le informazioni specifiche della personalizzazione. |
solutionId |
|
Obbligorio solo per soluzioni a livello di applicazione.Archivia le informazioni specifiche della personalizzazione. |
application loadBehavior keyName |
|
Elemento <friendlyName> (sviluppo per Office in Visual Studio) |
Parametro facoltativo.Archivia il nome del componente aggiuntivo che viene visualizzato nell'elenco di componenti aggiuntivi installati. |
Nessuno |
Elemento <description> (sviluppo per Office in Visual Studio) |
Obbligatorio solo per componenti aggiuntivi a livello di applicazione.Archivia la descrizione che viene visualizzata nell'elenco dei programmi installati. |
Nessuno |
Elemento <formRegions> (sviluppo per Office in Visual Studio) |
Obbligatorio solo per i componenti aggiuntivi di Outlook che includono aree di modulo. |
Nessuno |
Elemento <formRegion> (sviluppo per Office in Visual Studio) |
Obbligatorio solo per i componenti aggiuntivi di Outlook che includono aree di modulo. |
Name |
Elemento <vstoRuntime> (sviluppo per Office in Visual Studio) |
Obbligatorio.Descrive una versione specifica del runtime di Visual Studio Tools per Office supportata dalla soluzione Office. |
release version supportUrl |
Note
È possibile modificare manualmente i manifesti di applicazione e di distribuzione nelle soluzioni Office.In seguito, tali manifesti devono essere firmati nuovamente tramite lo Strumento per la generazione e la modifica di manifesti (mage.exe e mageui.exe).Per ulteriori informazioni, vedere Procedura: ripetere la firma dei manifesti dell'applicazione e di distribuzione.
Percorso file
Un manifesto di applicazione è specifico per una singola versione di una soluzione.Per questo motivo, i manifesti dell'applicazione devono essere memorizzati separatamente da quelli di distribuzione.Visual Studio copia i file specifici della versione in una sottodirectory chiamata dopo la versione associata nella sottodirectory File applicazione nella cartella di pubblicazione.
Sintassi del nome file
Il nome di un file manifesto dell'applicazione deve essere composto dal nome completo e dall'estensione dell'applicazione identificati nell'elemento assemblyIdentity, seguiti dall'estensione manifest.Un manifesto di applicazione che faccia riferimento, ad esempio, alla personalizzazione OutlookAddIn1.dll avrà il seguente nome file.
OutlookAddIn1.dll.manifest