Manifesti dell'applicazione per le soluzioni Office (System 2007)
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
Versione Microsoft Office
|
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.
Visual Studio Tools per Office utilizza lo schema del manifesto dell'applicazione di ClickOnce definito nel riferimento Manifesto dell'applicazione ClickOnce.
I manifesti dell'applicazione di Visual Studio Tools per Office utilizzano gli elementi e gli attributi ClickOnce riportati di seguito.
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 protezione 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. |
Nessuna |
|
Obbligatorio. Identifica ciascun file non assembly utilizzato dall'applicazione. Può includere i dati sull'isolamento COM (Component Object Model) associati al file. |
name size |
I manifesti di applicazione Visual Studio Tools per Office dispongono del seguente elemento nello spazio dei nomi co.v1.
<entryPoint>
<co.v1:customHostSpecified />
</entryPoint>
I manifesti dell'applicazione di Visual Studio Tools per Office dispongono inoltre degli elementi e degli attributi seguenti nello spazio dei nomi vstav2.
<addIn>
<entryPoints>
<entryPoint>
</entryPoint>
</entryPoints>
<update></update>
<application>
<customization>
</customization>
</application
</addIn>
Elemento |
Descrizione |
Attributi |
|---|---|---|
Obbligatorio. Contrassegna specificatamente il manifesto come soluzione Office. |
Nessuna |
|
Obbligatorio. Archivia i punti di ingresso in un solo spazio dei nomi. |
Nessuna |
|
Obbligatorio. Raggruppa tutti gli assembly da eseguire. |
Nessuna |
|
Obbligatorio. Identifica l'assembly da eseguire. |
class contract |
|
Obbligatorio. Configura gli aggiornamenti per la soluzione. |
enabled expiration |
|
Obbligatorio. Esegue il wrapping delle informazioni specifiche dell'applicazione in un solo nodo. |
Nessuna |
|
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 |
|
Facoltativo. Archivia il nome del componente aggiuntivo che viene visualizzato nell'elenco di componenti aggiuntivi installati. |
Nessuna |
|
Obbligatorio solo per componenti aggiuntivi a livello di applicazione. Archivia la descrizione che viene visualizzata nell'elenco dei programmi installati. |
Nessuna |
|
Obbligatorio solo per componenti aggiuntivi Outlook 2007 che includono aree di modulo. |
Nessuna |
|
Obbligatorio solo per componenti aggiuntivi Outlook 2007 che includono aree di modulo. |
name |
Note
È possibile modificare manualmente i manifesti dell'applicazione e di distribuzione nelle soluzioni Visual Studio Tools per Office. Dopo la modifica, è necessario firmare nuovamente i manifesti dell'applicazione e quelli di distribuzione utilizzando lo Strumento per la generazione e la modifica di manifesti (mage.exe e mageui.exe). Firmare prima il manifesto dell'applicazione e poi quello di distribuzione. Per ulteriori informazioni, vedere Strumento per la generazione e la modifica di manifesti (Mage.exe) e Strumento per la generazione e la modifica di manifesti con interfaccia grafica (MageUI.exe).
Percorso file
Un manifesto di applicazione è specifico per una singola versione di una soluzione. Per questo motivo, i manifesti di 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
ExcelWorkbook1.dll.manifest
Esempio di personalizzazione a livello di documento
Descrizione
Nell'esempio di codice seguente vengono illustrate le sezioni presenti in un manifesto dell'applicazione relativo a una soluzione Visual Studio Tools per Office. In questo esempio viene utilizzata una personalizzazione a livello di documento di Microsoft Office Excel 2007.
Codice
<entryPoint>
<co.v1:customHostSpecified />
</entryPoint>
[...]
<vstav2:addIn xmlns:vstav2="urn:schemas-microsoft-com:vsta.v2">
<vstav2:entryPoints>
<vstav2:entryPoint class="ExcelWorkbook1.ThisWorkbook">
<assemblyIdentity
name="ExcelWorkbook1"
version="1.0.0.0"
language="neutral"
processorArchitecture="msil" />
</vstav2:entryPoint>
<vstav2:entryPoint class="ExcelWorkbook1.Sheet1">
<assemblyIdentity
name="ExcelWorkbook1"
version="1.0.0.0"
language="neutral"
processorArchitecture="msil" />
</vstav2:entryPoint>
<vstav2:entryPoint class="ExcelWorkbook1.Sheet2">
<assemblyIdentity
name="ExcelWorkbook1"
version="1.0.0.0"
language="neutral"
processorArchitecture="msil" />
</vstav2:entryPoint>
<vstav2:entryPoint class="ExcelWorkbook1.Sheet3">
<assemblyIdentity
name="ExcelWorkbook1"
version="1.0.0.0"
language="neutral"
processorArchitecture="msil" />
</vstav2:entryPoint>
</vstav2:entryPoints>
<vstav2:update enabled="true">
<vstav2:expiration maximumAge="7" unit="days" />
</vstav2:update>
<vstav2:application>
<vstov3:customization
xmlns:vstov3="urn:schemas-microsoft-com:vsto.v3">
<vstov3:document
solutionId="989..." />
</vstov3:customization>
</vstav2:application>
</vstav2:addIn>
Esempio di componente aggiuntivo a livello di applicazione
Descrizione
Nell'esempio di codice seguente vengono illustrate le sezioni presenti in un manifesto dell'applicazione relativo a una soluzione Visual Studio Tools per Office. Si tratta di un Microsoft Office Outlook 2007 componente aggiuntivo a livello di applicazione che include un'area di modulo.
Codice
<entryPoint>
<co.v1:customHostSpecified />
</entryPoint>
[...]
<vstav2:addIn xmlns:vstav2="urn:schemas-microsoft-com:vsta.v2">
<vstav2:entryPoints>
<vstav2:entryPoint class="OutlookAddIn1.ThisAddIn">
<assemblyIdentity
name="OutlookAddIn1"
version="1.0.0.0"
language="neutral"
processorArchitecture="msil" />
</vstav2:entryPoint>
</vstav2:entryPoints>
<vstav2:update enabled="true">
<vstav2:expiration maximumAge="7" unit="days" />
</vstav2:update>
<vstav2:application>
<vstov3:customization
xmlns:vstov3="urn:schemas-microsoft-com:vsto.v3">
<vstov3:appAddIn
application="Outlook"
loadBehavior="3"
keyName="OutlookAddIn1">
<vstov3:friendlyName>
OutlookAddIn1
</vstov3:friendlyName>
<vstov3:description>
OutlookAddIn1 - Outlook add-in created with
Visual Studio Tools for Office
</vstov3:description>
<vstov3:formRegions>
<vstov3:formRegion
name="OutlookAddIn1.FormRegion1">
<vstov3:messageClass name="IPM.Note" />
<vstov3:messageClass name="IPM.Contact" />
<vstov3:messageClass name="IPM.Appointment" />
</vstov3:formRegion>
</vstov3:formRegions>
</vstov3:appAddIn>
</vstov3:customization>
</vstav2:application>
</vstav2:addIn>
Vedere anche
Riferimenti
Manifesti dell'applicazione per le soluzioni Office (System 2007)
Manifesti di distribuzione per le soluzioni Office (System 2007)