Compartilhar via


Visão geral das propriedades do documento personalizado

Quando você cria um projeto no nível do documento, o Visual Studio adiciona duas propriedades personalizadas ao documento no projeto: _AssemblyLocation e _AssemblyName. Quando um usuário abre um documento, o aplicativo do Microsoft Office verifica essas propriedades de documento personalizadas. Se existirem no documento, o aplicativo carregará o runtime do Visual Studio Tools for Office, que inicia a personalização. Para obter mais informações, consulte Arquitetura das soluções do Office no Visual Studio.

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento para Excel e Word. Para obter mais informações, consulte Os recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

_AssemblyName

Esta propriedade contém o CLSID de uma interface no componente do carregador de solução do Office das Ferramentas do Visual Studio para o runtime do Office. O valor CLSID é 4E3C66D5-58D4-491E-A7D4-64AF99AF6E8B. Você nunca deve alterar esse valor.

_AssemblyLocation

Essa propriedade contém uma cadeia de caracteres que fornece detalhes sobre o manifesto de implantação para a personalização. Para obter mais informações sobre manifestos, consulte manifestos de aplicativo e implantação em soluções do Office.

O valor da propriedade _AssemblyLocation pode ter formatos diferentes, dependendo de como a solução é implantada:

  • Se a solução for publicada para ser instalada em um site, caminho UNC ou uma unidade de CD ou USB, a propriedade _AssemblyLocation terá o formato DeploymentManifestPath|SolutionID. A seguinte cadeia de caracteres é um exemplo:

    file://deployserver/MyShare/ExcelWorkbook1.vsto|74744e4b-e4d6-41eb-84f7-ad20346fe2d9

  • Se você estiver executando ou depurando a solução do Visual Studio, a propriedade _AssemblyLocation terá o formato DeploymentManifestName|SolutionID|vstolocal. A seguinte cadeia de caracteres é um exemplo:

    ExcelWorkbook1.vsto|74744e4b-e4d6-41eb-84f7-ad20346fe2d9|vstolocal

    O SolutionID é um GUID que as Ferramentas do Visual Studio para o runtime do Office usam para identificar a solução. A SolutionID é gerada automaticamente quando você cria o projeto. O termo vstolocal informa ao tempo de execução das Ferramentas do Visual Studio para Office que o assembly deve ser carregado na mesma pasta que contém o documento.