Manifestos de aplicativo para soluções do Office

Artigo
08/01/2011

Um manifesto de aplicativo é um arquivo XML que descreve os assemblies que são carregados em uma solução de Microsoft Office. A usar as ferramentas de desenvolvimento de Microsoft Office em Visual Studio a ClickOnce esquema de manifesto de aplicativo definida o Manifesto de aplicativo ClickOnce de referência.

Manifestos de aplicativos para soluções do Office usam o seguinte ClickOnce elementos e atributos.

Element	Description	Attributes
<<>>assembly > Elemento (<>>aplicativo ClickOnce)	Required. Top-level element.	manifestVersion
<assemblyIdentity> Elemento (<>>aplicativo ClickOnce)	Required. Identifica o ClickOnce assembly principal. do aplicativo	name version publicKeyToken processorArchitecture language
<trustInfo> Elemento (<>>aplicativo ClickOnce)	Identifica os requisitos de segurança do aplicativo.	None
<entryPoint> Elemento (<>>aplicativo ClickOnce)	Required. Identifies the application code entry point for execution.	name dependencyName customHostSpecified
<dependency> Elemento (<>>aplicativo ClickOnce)	Required. Identifies each dependency required for the application to run. Optionally identifies assemblies that need to be preinstalled.	None
<file> Elemento (<>>aplicativo ClickOnce)	Required. Identifica cada arquivo do assembly não é usado pelo aplicativo. Can include Component Object Model (COM) isolation data associated with the file.	name size

Manifestos de aplicativos para soluções do Office tem o seguinte elemento co.v1 namespace.

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint>

Esses manifestos de aplicativo também tem os seguintes elementos e atributos do vstav3 namespace.

<addIn>
  <entryPointsCollection>
    <entryPoints>
      <entryPoint>
      </entryPoint>
    </entryPoints>
  </entryPointsCollection>
  <update></update>
  <postActions>
    <postAction>
      <postActionData>
      </postActionData>
    <postAction>
  </postActions>
  <application>
    <customizations>
      <customization>
      </customization>
    </customizations>
  </application
</addIn>

Element	Description	Attributes
<customHostSpecified> Elemento (desenvolvimento do Office em Visual Studio)	Required. Marca o manifesto especificamente como uma solução do Office.	None
<addin> Elemento (desenvolvimento do Office em Visual Studio)	Required. Armazena pontos de entrada em um único namespace.	None
<entryPointsCollection> Elemento (desenvolvimento do Office em Visual Studio)	Required. Agrupa todos os assemblies para uma ou mais soluções do Office.	id
<entryPoints> Elemento (desenvolvimento do Office em Visual Studio)	Required. Agrupa todos os assemblies para executar uma solução do Office.	None
<entryPoint> Elemento (desenvolvimento do Office em Visual Studio)	Required. Identifica o assembly seja executado em uma solução do Office.	class contract
<update> Elemento (desenvolvimento do Office em Visual Studio)	Required. Configura as atualizações para a solução.	enabled expiration
<postActions> Elemento (desenvolvimento do Office em Visual Studio)	Optional. Agrupa todas as pós-implantação ações, que são executados após a instalação de soluções do Office.	None
<postAction> Elemento (desenvolvimento do Office em Visual Studio)	Optional. Identifica uma ação de pós-implantação.	None
<postActionData> Elemento (desenvolvimento do Office em Visual Studio)	Optional. Configura os dados para uma ação de pós-implantação.	None
<application> Elemento (desenvolvimento do Office em Visual Studio)	Required. Encapsula as informações específicas do aplicativo em um único nó.	None
<customizations> Elemento (desenvolvimento do Office em Visual Studio)	Required. Armazena todas as informações de host específicos do aplicativo em um namespace separado.	None
<customization> Elemento (desenvolvimento do Office em Visual Studio)	Required. Armazena informações de host específicos do aplicativo em um namespace separado.	xmlns
<document> Elemento (desenvolvimento do Office em Visual Studio)	Necessário apenas para as soluções de nível de documento. Armazena informações específicas de personalização.	solutionId
<appAddin> Elemento (desenvolvimento do Office em Visual Studio)	Necessário apenas para as soluções de nível de aplicativo. Armazena informações específicas de personalização.	application loadBehavior keyName
<friendlyName> Elemento (desenvolvimento do Office em Visual Studio)	Optional. Armazena o nome do suplemento que aparece na lista de suplementos instalados.	None
<description> Elemento (desenvolvimento do Office em Visual Studio)	Necessário apenas para suplementos de nível de aplicativo. Armazena a descrição que aparece na lista de programas instalados.	None
<formRegions> Elemento (desenvolvimento do Office em Visual Studio)	Necessário apenas para o Outlook 2007 add-ins incluem regiões de formulário.	None
<formRegion> Elemento (desenvolvimento do Office em Visual Studio)	Necessário apenas para o Outlook 2007 add-ins incluem regiões de formulário.	Name
<vstoRuntime> Elemento (desenvolvimento do Office em Visual Studio)	Required. Descreve uma versão específica do Visual Studio Tools para Office runtime que é compatível com a solução do Office.	release version supportUrl

Comentários

Você pode editar manualmente o aplicativo e manifestos de implantação em soluções do Office. Posteriormente, você deve assinar novamente o aplicativo e manifestos de implantação usando a ferramenta de edição (Mage e mageui.exe) e geração de manifesto. For more information, see Como: Re-.

File Location

Um manifesto de aplicativo é específico para uma única versão de uma solução. Por esse motivo, os manifestos de aplicativo devem ser armazenados separadamente dos manifestos de implantação. Visual Studiocoloca os arquivos específicos de versão em um subdiretório nomeado de acordo com a versão associada na Arquivos de aplicativo a subpasta na pasta de publicação.

File Name Syntax

O nome de um arquivo de manifesto do aplicativo deve ser o nome completo e a extensão do aplicativo conforme identificado na assemblyIdentity elemento, seguido pela extensão. manifest. Por exemplo, um manifesto de aplicativo que se refere à personalização OutlookAddIn1.dll usaria a seguinte sintaxe de nome de arquivo.

OutlookAddIn1.dll.manifest

Exemplo de personalização de nível de documento

Description

O exemplo de código a seguir ilustra as seções de um manifesto de aplicativo que são específicas para um Visual Studio Tools for Office solução. Este exemplo descreve uma personalização em nível de documento Microsoft Office Excel 2007.

Code

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint> 
[...]
<vstav3:addIn 
  xmlns:vstav3="urn:schemas-microsoft-com:vsta.v3">
  <vstav3:entryPointsCollection>
    <vstav3:entryPoints>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.ThisWorkbook">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.Sheet1">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.Sheet2">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.Sheet3">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
    </vstav3:entryPoints>
  </vstav3:entryPointsCollection>
  <vstav3:update 
    enabled="true">
    <vstav3:expiration 
      maximumAge="7" 
      unit="days" />
  </vstav3:update>
  <vstav3:application>
    <vstov4:customizations 
      xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
      <vstov4:customization>
        <vstov4:document 
          solutionId="73e" />
      </vstov4:customization>
    </vstov4:customizations>
  </vstav3:application>
</vstav3:addIn>

Nível de aplicativo no exemplo de-

Description

O exemplo de código a seguir ilustra as seções de um manifesto de aplicativo que são específicas para um Visual Studio Tools for Office solução. Este exemplo descreve um Microsoft Office Outlook nível de aplicativo suplemento 2007 que inclui uma região de formulário.

Code

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint> 
[...]
<vstav3:addIn 
  xmlns:vstav3="urn:schemas-microsoft-com:vsta.v3">
  <vstav3:entryPointsCollection>
    <vstav3:entryPoints>
      <vstav3:entryPoint 
        class="ContosoOutlookAddIn.ThisAddIn">
        <assemblyIdentity 
          name="ContosoOutlookAddIn" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
    </vstav3:entryPoints>
  </vstav3:entryPointsCollection>
  <vstav3:update 
    enabled="true">
    <vstav3:expiration 
      maximumAge="7" 
      unit="days" />
  </vstav3:update>
  <vstav3:application>
    <vstov4:customizations 
      xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
      <vstov4:customization>
        <vstov4:appAddIn 
          application="Outlook" 
          loadBehavior="3" 
          keyName="ContosoOutlookAddIn">
          <vstov4:friendlyName>
            ContosoOutlookAddIn
          </vstov4:friendlyName>
          <vstov4:description>
            ContosoOutlookAddIn - Outlook add-in 
            created with Visual Studio Tools for Office
          </vstov4:description>
          <vstov4:formRegions>
            <vstov4:formRegion
                name="OutlookAddIn1.FormRegion1">
              <vstov4:messageClass name="IPM.Note" />
              <vstov4:messageClass name="IPM.Contact" />
              <vstov4:messageClass name="IPM.Appointment" />
            </vstov4:formRegion>
          </vstov4:formRegions>
        </vstov4:appAddIn>
      </vstov4:customization>
    </vstov4:customizations>
  </vstav3:application>
</vstav3:addIn>

Exemplo de implantação de multiprojetos

Description

O exemplo de código a seguir ilustra as seções de um manifesto de aplicativo que são específicas para um Visual Studio Tools for Office solução. Este exemplo descreve uma implantação de multiprojeto instala um suplemento da nível do aplicativo Microsoft Outlook 2007 com uma região de formulário e uma personalização de nível de documento do Microsoft Excel 2007.

Code

  <entryPoint>
    <co.v1:customHostSpecified />
  </entryPoint>
[...]
  <dependency>
    <dependentAssembly 
      dependencyType="install" 
      allowDelayedBinding="true" 
      codebase="ContosoExcelWorkbook.dll" 
      size="12800">
      <assemblyIdentity 
        name="ContosoExcelWorkbook" 
        version="1.0.0.0" 
        language="neutral" 
        processorArchitecture="msil" />
      <hash>
        <dsig:Transforms>
          <dsig:Transform Algorithm=
            "urn:schemas-microsoft-com:HashTransforms.Identity" />
        </dsig:Transforms>
        <dsig:DigestMethod Algorithm=
            "http://www.w3.org/2000/09/xmldsig#sha1" />
        <dsig:DigestValue>ONF</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
  <dependency>
    <dependentAssembly 
      dependencyType="install" 
      allowDelayedBinding="true" 
      codebase="ContosoOutlookAddIn.dll" 
      size="10240">
      <assemblyIdentity 
        name="ContosoOutlookAddIn" 
        version="1.0.0.0" 
        language="neutral" 
        processorArchitecture="msil" />
      <hash>
        <dsig:Transforms>
          <dsig:Transform Algorithm=
            "urn:schemas-microsoft-com:HashTransforms.Identity" />
        </dsig:Transforms>
        <dsig:DigestMethod Algorithm=
            "http://www.w3.org/2000/09/xmldsig#sha1" />
        <dsig:DigestValue>i4e</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
  <vstav3:addIn 
    xmlns:vstav3="urn:schemas-microsoft-com:vsta.v3">
    <vstav3:entryPointsCollection>
      <vstav3:entryPoints 
        id="ContosoExcel">
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.ThisWorkbook">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.Sheet1">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.Sheet2">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.Sheet3">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
      </vstav3:entryPoints>
      <vstav3:entryPoints 
        id="ContosoOutlook">
        <vstav3:entryPoint 
          class="ContosoOutlookAddIn.ThisAddIn">
          <assemblyIdentity 
            name="ContosoOutlookAddIn" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
      </vstav3:entryPoints>
    </vstav3:entryPointsCollection>
    <vstav3:update 
      enabled="true">
      <vstav3:expiration 
        maximumAge="7" 
        unit="days" />
    </vstav3:update>
    <vstav3:application>
      <vstov4:customizations 
        xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
        <vstov4:customization 
          id="ContosoExcel">
          <vstov4:document 
            solutionId="73ec4ba9-a983-40b3-af63-5fb172ea81db" />
        </vstov4:customization>
        <vstov4:customization 
          id="ContosoOutlook">
          <vstov4:appAddIn 
            application="Outlook" 
            loadBehavior="3" 
            keyName="ContosoOutlookAddIn">
            <vstov4:friendlyName>
              ContosoOutlookAddIn
            </vstov4:friendlyName>
            <vstov4:description>
              ContosoOutlookAddIn - Outlook add-in created with 
              Visual Studio Tools for Office
            </vstov4:description>
          </vstov4:appAddIn>
        </vstov4:customization>
      </vstov4:customizations>
    </vstav3:application>
  </vstav3:addIn>

Exemplo de ações pós-implantação

Description

O exemplo de código a seguir ilustra as seções de um manifesto de aplicativo que são específicas para um Visual Studio Tools for Office solução. Este exemplo descreve uma ação de pós-implantação cria uma chave do registro após a conclusão da instalação.

Code

<vstav3:postActions>
  <vstav3:postAction>
    <vstav3:entryPoint 
      class="PostDeploymentAction.PostDeploymentActionSample">
      <assemblyIdentity 
        name="PostDeploymentAction" 
        version="1.0.0.0" 
        language="neutral" 
        processorArchitecture="msil" />
    </vstav3:entryPoint>
    <vstav3:postActionData>
    </vstav3:postActionData>
  </vstav3:postAction>
</vstav3:postActions>

Consulte também

Referência

Manifestos de implantação de soluções do Office

Manifesto de aplicativo ClickOnce

Compartilhar via

Manifestos de aplicativo para soluções do Office

Comentários

File Location

File Name Syntax

Exemplo de personalização de nível de documento

Description

Code

Nível de aplicativo no exemplo de-

Description

Code

Exemplo de implantação de multiprojetos

Description

Code

Exemplo de ações pós-implantação

Description

Code

Consulte também

Referência

Recursos adicionais