Cenni preliminari sulle proprietà personalizzate dei documenti
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
Versione Microsoft Office
Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione. |
Quando un documento fa parte di una personalizzazione a livello di documento, Visual Studio Tools per Office assegna a tale documento due proprietà personalizzate: _AssemblyLocation e _AssemblyName. Quando un utente apre un documento, l'applicazione di Microsoft Office verifica la presenza di queste proprietà di documento personalizzate. Se tale verifica ha esito positivo, l'applicazione carica il runtime di Visual Studio Tools per Office che quindi avvia la personalizzazione. Per ulteriori informazioni, vedere la classe Architettura di soluzioni Visual Studio Tools per Office.
I valori di queste proprietà dipendono dalla versione di Microsoft Office per cui la soluzione è progettata:
Microsoft Office 2007.
Microsoft Office 2003.
Proprietà personalizzate per le soluzioni Microsoft Office 2007
_AssemblyName
Questa proprietà contiene il CLSID di un'interfaccia del caricatore di Visual Studio Tools per Office. Il valore CLSID è 4E3C66D5-58D4-491E-A7D4-64AF99AF6E8B. Evitare di modificare questo valore.
_AssemblyLocation
Questa proprietà contiene una stringa che fornisce dettagli sul manifesto di distribuzione della personalizzazione. Per ulteriori informazioni sui manifesti, vedere Manifesti dell'applicazione e di distribuzione nelle soluzioni di Office.
Formato della proprietà _AssemblyLocation
Il formato del valore della proprietà _AssemblyLocation varia a seconda della modalità di distribuzione della soluzione:
Se la soluzione è pubblicata per essere installata da un sito Web, un percorso UNC oppure un'unità CD-ROM o USB, la proprietà _AssemblyLocation presenta il formato PercorsoManifestoDistribuzione|IDSoluzione. Ad esempio:
file://deployserver/MyShare/ExcelWorkbook1.vsto|74744e4b-e4d6-41eb-84f7-ad20346fe2d9
Durante l'esecuzione o il debug della soluzione in Visual Studio, la proprietà _AssemblyLocation presenta il formato NomeDistribuzioneManifesto|IDSoluzione|vstolocal. Ad esempio:
ExcelWorkbook1.vsto|74744e4b-e4d6-41eb-84f7-ad20346fe2d9|vstolocal
L'IDSoluzione è un GUID utilizzato dal runtime di Visual Studio Tools per Office per identificare la soluzione. L'IDSoluzione viene generato automaticamente quando si compila il progetto. Il termine vstolocal indica al runtime di Visual Studio Tools per Office che l'assembly deve essere caricato dalla stessa cartella in cui si trova il documento.
Proprietà personalizzate per le soluzioni Microsoft Office 2003
_AssemblyName
Questa proprietà contiene un asterisco (*). Tale simbolo indica all'applicazione di Microsoft Office che il documento presenta una personalizzazione di Visual Studio Tools per Office.
_AssemblyLocation
Questa proprietà contiene un GUID del controllo Runtime Storage. Per ulteriori informazioni, vedere Cenni preliminari sul controllo Runtime Storage.
Vedere anche
Attività
Procedura: distribuire una soluzione Office utilizzando ClickOnce (2007 System)
Procedura: creare e modificare proprietà personalizzate di un documento
Concetti
Architettura delle personalizzazioni a livello di documento
Cenni preliminari sul controllo Runtime Storage
Manifesti dell'applicazione e di distribuzione nelle soluzioni di Office