Custom Document Properties Overview
When you build a document-level project, Visual Studio adds two custom properties to the document in the project: _AssemblyLocation and _AssemblyName. When a user opens a document, the Microsoft Office application checks for these custom document properties. If they exist in the document, the application loads the Visual Studio Tools for Office runtime, which starts the customization. For more information, see Architecture of Office Solutions in Visual Studio.
Applies to: The information in this topic applies to document-level projects for the following applications: Excel 2007 and Excel 2010; Word 2007 and Word 2010. For more information, see Features Available by Office Application and Project Type.
_AssemblyName
This property contains the CLSID of an interface in the Office solution loader component of the Visual Studio Tools for Office runtime. The CLSID value is 4E3C66D5-58D4-491E-A7D4-64AF99AF6E8B. You should never change this value.
_AssemblyLocation
This property contains a string that provides details about the deployment manifest for the customization. For more information about manifests, see Application and Deployment Manifests in Office Solutions.
The**_AssemblyLocation** property value can have different formats, depending on how the solution is deployed:
If the solution is published to be installed from a Web site, UNC path, or a CD or USB drive, the _AssemblyLocation property has the format DeploymentManifestPath|SolutionID. The following string is an example:
file://deployserver/MyShare/ExcelWorkbook1.vsto|74744e4b-e4d6-41eb-84f7-ad20346fe2d9
If you are running or debugging the solution from Visual Studio, the _AssemblyLocation property has the format DeploymentManifestName|SolutionID|vstolocal. The following string is an example:
ExcelWorkbook1.vsto|74744e4b-e4d6-41eb-84f7-ad20346fe2d9|vstolocal
The SolutionID is a GUID that the Visual Studio Tools for Office runtime uses to identify the solution. The SolutionID is automatically generated when you build the project. The vstolocal term indicates to the Visual Studio Tools for Office runtime that the assembly should be loaded from the same folder as the document.
See Also
Tasks
How to: Publish an Office Solution by Using ClickOnce
How to: Create and Modify Custom Document Properties
Concepts
Architecture of Document-Level Customizations
Application and Deployment Manifests in Office Solutions