Manifestos do assembly

  • Artigo

Um manifesto do assembly é um arquivo XML que descreve um assembly lado a lado. Os manifestos de assembly descrevem os nomes e versões de assemblies, arquivos e recursos lado a lado do assembly, bem como a dependência do assembly em outros assemblies lado a lado. A instalação, a ativação e a execução corretas de assemblies lado a lado exigem que o manifesto do assembly sempre acompanhe um assembly no sistema.

Para obter uma listagem completa do esquema XML, consulte Esquema de arquivo de manifesto.

Os manifestos de assembly têm os seguintes elementos e atributos.

Elemento Atributos Obrigatório
Assembly Sim
manifestVersion Sim
noInheritable Não
assemblyIdentity Sim
tipo Sim
name Sim
linguagem Não
Processorarchitecture Não
version Sim
publicKeyToken Não
Dependência Não
dependentAssembly Não
file Não
name Sim
Hashalg Não
hash Não
comClass No
descrição Não
clsid Sim
Threadingmodel Não
tlbid Não
progid Não
Miscstatus Não
miscStatusIcon Não
miscStatusContent Não
miscStatusDocPrint Não
miscStatusThumbnail Não
Typelib Não
tlbid Sim
version Sim
helpdir Sim
Resourceid Não
sinalizadores Não
comInterfaceExternalProxyStub Não
iid Sim
Baseinterface Não
numMethods Não
name Não
tlbid Não
proxyStubClsid32 Não
comInterfaceProxyStub Não
iid Sim
name Sim
tlbid Não
Baseinterface Não
numMethods Não
proxyStubClsid32 Não
Threadingmodel Não
windowClass Não
Versionado Não

Localização do arquivo

Os manifestos do assembly podem ser instalados em três locais:

  • Como manifestos que acompanham assemblies compartilhados, os manifestos do assembly devem ser instalados como um arquivo separado no cache de assembly lado a lado. Geralmente, essa é a pasta WinSxS no diretório do Windows.
  • Como manifestos que acompanham assemblies privados, os manifestos de assembly devem ser instalados na estrutura de diretório do aplicativo. Geralmente, esse é um arquivo separado na mesma pasta que o arquivo executável do aplicativo.
  • Como um recurso em uma DLL, o assembly está disponível para o uso privado da DLL. Um manifesto do assembly não pode ser incluído como um recurso em um EXE. Um arquivo EXE pode incluir um manifesto do aplicativo como um recurso.

Sintaxe do nome do arquivo

O nome de um manifesto do assembly é qualquer nome de arquivo válido seguido por .manifest.

Por exemplo, um manifesto do assembly que se refere a myassembly usaria a seguinte sintaxe de nome de arquivo: myassembly.<resource ID>.manifest. Você poderá omitir o <resource ID> campo se o manifesto do assembly estiver sendo instalado como um arquivo separado ou se a ID do recurso for 1.

Observação

Devido à maneira como pesquisa lado a lado assemblies privados, as restrições de nomenclatura a seguir se aplicam ao empacotar uma DLL como um assembly privado. Uma maneira recomendada de fazer isso é colocar o manifesto do assembly na DLL como um recurso. Nesse caso, a ID do recurso deve ser igual a 1 e o nome do assembly privado pode ser o mesmo que o nome da DLL. Por exemplo, se o nome da DLL for Microsoft.Windows.mysample.dll, o valor do atributo name usado no elemento assemblyIdentity do manifesto também poderá ser Microsoft.Windows.mysample. Uma maneira alternativa é colocar o manifesto do assembly em um arquivo separado. Nesse caso, o nome do assembly e seu manifesto devem ser diferentes do nome da DLL. Por exemplo, Microsoft.Windows.mysampleAsm, Microsoft.Windows.mysampleAsm.manifest e Microsoft.Windows.Mysample.dll. Para obter mais informações sobre como pesquisa lado a lado para assemblies privados, consulte Sequência de pesquisa de assembly.

Elementos

Nomes de elementos e atributos diferenciam maiúsculas de minúsculas. Os valores de elementos e atributos não diferenciam maiúsculas de minúsculas, exceto pelo valor do atributo de tipo.

Assembly

Um elemento container. Seu primeiro subelemento deve ser um elemento assemblyIdentity ou noInheritable . O manifesto do assembly descreve exclusivamente o assembly lado a lado identificado pela assemblyIdentity. Obrigatórios.

O elemento assembly deve estar no namespace "urn:schemas-microsoft-com:asm.v1". Os elementos filho do assembly também devem estar nesse namespace, por herança ou marcação.

O elemento assembly tem o seguinte atributo.

Atributo Descrição
manifestVersion O atributo manifestVersion deve ser definido como 1.0.

noInheritable

Inclua esse elemento em um manifesto de assembly para indicar que o assembly gerencia os contextos de ativação e seus objetos. O elemento noInheritable deve ser um subelemento de um elemento assembly . O elemento assemblyIdentity deve vir após qualquer elemento noInheritable . O elemento noInheritable será necessário no manifesto do assembly se o assembly for usado por qualquer manifesto de aplicativo que inclua o elemento noInherit . Um elemento noInheritable em um manifesto do aplicativo não tem efeito. Um elemento noInheritable não tem elementos filho.

Assemblyidentity

Descreve e identifica exclusivamente um assembly lado a lado.

Como o primeiro subelemento de um elemento assembly , assemblyIdentity descreve e identifica exclusivamente o assembly lado a lado que possui esse manifesto do assembly. Isso é chamado de assemblyIdentity de contexto DEF do manifesto do assembly.

Como o primeiro subelemento de um elemento dependentAssembly , assemblyIdentity descreve e identifica exclusivamente um assembly lado a lado usado pela assemblyIdentity de contexto DEF. Isso é chamado de assemblyIdentity de contexto REF do manifesto do assembly. O assembly de contexto DEF requer que o assembly de contexto REF funcione corretamente. Observe que cada assemblyIdentity de contexto REF deve corresponder exatamente a uma assemblyIdentity de contexto DEF correspondente no manifesto do assembly referenciado.

Esse elemento não tem subelementos. O elemento assemblyIdentity tem os seguintes atributos.

Atributo Descrição
tipo Especifica o tipo de assembly. O valor deve ser win32 e, em letras minúsculas. Obrigatórios.
name Nomeia exclusivamente o assembly. Use o seguinte formato para o nome do assembly: Organization.Division.Name. Por exemplo, Microsoft.Windows.mysampleAsm. Obrigatórios. Observe que, no caso de uma DLL empacotada como um assembly privado com um arquivo de manifesto separado, o nome do assembly deve ser diferente do nome da DLL e do manifesto.
linguagem Identifica o idioma do assembly. Opcional. Se o assembly for específico do idioma, especifique o código de linguagem DHTML. No assemblyIdentity de contexto DEF de um manifesto de assembly destinado ao uso mundial (idioma neutro) omita o atributo de linguagem.
Em um assemblyIdentity de contexto REF de um manifesto de assembly destinado ao uso mundial (idioma neutro) defina o valor da linguagem como "*".
Processorarchitecture Especifica o processador. Os valores válidos são x86 para Windows de 32 bits e ia64 para Windows de 64 bits. Opcional.
version Especifica a versão do assembly. Use o formato de versão de quatro partes: mmmmm.nnnnn.ooooo.ppppp. Cada uma das partes separadas por períodos pode ser 0-65535 inclusive. Para obter mais informações, consulte Versões de assembly. Obrigatórios.
publicKeyToken Uma cadeia de caracteres hexadecimal de 16 caracteres que representa os últimos 8 bytes do hash SHA-1 da chave pública sob a qual o assembly é assinado. A chave pública usada para assinar o catálogo deve ter 2.048 bits ou mais. Necessário para assemblies lado a lado compartilhados.

Dependência

Um elemento de contêiner, incluindo pelo menos um dependentAssembly. O primeiro subelemento deve ser um elemento dependentAssembly . Uma dependência não tem atributos. Opcional.

Dependentassembly

O primeiro subelemento deve ser um elemento assemblyIdentity que descreve e identifica exclusivamente um assembly lado a lado que é usado pelo assembly lado a lado que possui esse manifesto do assembly. Cada dependentAssembly deve estar dentro exatamente de uma dependência. Opcional.

Arquivo

Contém arquivos usados por um assembly lado a lado. Contém subelementos comClass, typelib, windowClass, comInterfaceProxyStub . Opcional.

O elemento de arquivo tem os seguintes atributos.

Atributo Descrição
name O nome do arquivo, por exemplo, Conctl32.dll.
Hashalg Algoritmo usado para criar um hash do arquivo. Esse valor deve ser SHA1.
hash Um hash do arquivo referenciado pelo nome. Uma cadeia de caracteres hexadecimal de comprimento dependendo do algoritmo de hash.

Comclass

Um subelemento de um elemento de arquivo . Opcional.

O elemento comClass tem os seguintes atributos.

Atributo Descrição
descrição Nome da classe.
clsid O GUID que identifica exclusivamente a Classe . Obrigatórios. O valor deve estar no formato de um GUID válido.
Threadingmodel O modelo de threading usado por classes COM no processo. Se essa propriedade for nula, nenhum modelo de threading será usado. O componente é criado no thread principal do cliente e o marshaling de chamadas de outros threads é realizado para esse thread. Opcional. Os valores válidos são: "Apartment", "Free", "Both" e "Neutral".
tlbid Obtém o GUID para a biblioteca de tipos para este componente COM. O valor deve estar no formato de um GUID. Opcional.
progid Identificador programático dependente de versão associado ao componente COM. O formato de um ProgID é <fornecedor>.<componente>.<versão>.
Miscstatus Duplica no manifesto do assembly as informações fornecidas pela chave do Registro MiscStatus. Se os valores dos atributos miscStatusIcon, miscStatusContent, miscStatusDocprint ou miscStatusThumbnail não forem encontrados, o valor padrão correspondente listado em miscStatus será usado para os atributos ausentes. O valor pode ser uma lista delimitada por vírgulas dos valores de atributo da tabela abaixo. Você poderá usar esse atributo se a classe COM for uma classe OCX que exija valores de chave do Registro Miscstatus.
miscStatusIcon Duplica no manifesto do assembly as informações fornecidas por DVASPECT_ICON. Ele pode fornecer um ícone de um objeto. O valor pode ser uma lista delimitada por vírgulas dos valores de atributo da tabela abaixo. Você poderá usar esse atributo se a classe COM for uma classe OCX que exija valores de chave do Registro Miscstatus.
miscStatusContent Duplica no manifesto do assembly as informações fornecidas por DVASPECT_CONTENT. Ele pode fornecer um documento composto que pode ser exibido para uma tela ou impressora. O valor pode ser uma lista delimitada por vírgulas dos valores de atributo da tabela abaixo. Você poderá usar esse atributo se a classe COM for uma classe OCX que exija valores de chave do Registro Miscstatus.
miscStatusDocprint Duplica no manifesto do assembly as informações fornecidas por DVASPECT_DOCPRINT. Ele pode fornecer uma representação de objeto exibivel na tela como se fosse impressa em uma impressora. O valor pode ser uma lista delimitada por vírgulas dos valores de atributo da tabela abaixo. Você poderá usar esse atributo se a classe COM for uma classe OCX que exija valores de chave do Registro Miscstatus.
miscStatusThumbnail Duplicatas em um assembly manifestam as informações fornecidas por DVASPECT_THUMBNAIL. Ele pode fornecer uma miniatura de um objeto que pode ser exibido em uma ferramenta de navegação. O valor pode ser uma lista delimitada por vírgulas dos valores de atributo da tabela abaixo. Você poderá usar esse atributo se a classe COM for uma classe OCX que exija valores de chave do Registro Miscstatus.

O elemento comClass pode ter <elementos progid>... como filhos, que listam os progids dependentes de versão.

O exemplo a seguir mostra um elemento comClass incluído em um elemento de arquivo .

<file name="sampleu.dll">
        <comClass description="Font Property Page"
    clsid="{0BE35200-8F91-11CE-9DE3-00AA004BB851}"
          threadingModel = "Both"
             tlbid = "{44EC0535-400F-11D0-9DCD-00A0C90391D3}"/>
        <comClass description="Color Property Page"
    clsid="{0BE35201-8F91-11CE-9DE3-00AA004BB851}" 
    progid="ABC.Registrar"/>
    </file>

Se a classe COM for uma classe OCX que requer a subchave do Registro MiscStatus para especificar como criar e exibir um objeto, você poderá habilitar o objeto duplicando essas informações no manifesto do assembly. Especifique as características do objeto usando os atributos miscStatus, miscStatusIcon, miscStatusContent, miscStatusDocprint e miscStatusThumbnail do elemento comClass . Defina esses atributos como uma lista separada por vírgulas de valores de atributo da tabela a seguir. Esses atributos duplicam as informações que seriam fornecidas por uma enumeração DVASPECT. Se um valor não for encontrado para miscStatusIcon, miscStatusContent, miscStatusDocprint ou miscStatusThumbnail, os valores padrão especificados em miscStatus serão usados. Use valores de atributo da tabela a seguir. Eles correspondem aos sinalizadores de bit de uma enumeração OLEMISC .

Valor do atributo Constante OLEMISC
recomposeonresize OLEMISC_RECOMPOSEONRESIZE
onlyiconic OLEMISC_ONLYICONIC
insertnotreplace OLEMISC_INSERTNOTREPLACE
static OLEMISC_STATIC
cantlinkinside OLEMISC_CANTLINKINSIDE
canlinkbyole1 OLEMISC_CANLINKBYOLE1
islinkobject OLEMISC_ISLINKOBJECT
insideout OLEMISC_INSIDEOUT
activatewhenvisible OLEMISC_ACTIVATEWHENVISIBLE
renderingisdeviceindependent OLEMISC_RENDERINGISDEVICEINDEPENDENT
invisibleatruntime OLEMISC_INVISIBLEATRUNTIME
alwaysrun OLEMISC_ALWAYSRUN
actslikebutton OLEMISC_ACTSLIKEBUTTON
actslikelabel OLEMISC_ACTSLIKELABEL
nouiactivate OLEMISC_NOUIACTIVATE
alinhável OLEMISC_ALIGNABLE
simpleframe OLEMISC_SIMPLEFRAME
setclientsitefirst OLEMISC_SETCLIENTSITEFIRST
Imemode TOLEMISC_IMEMODE
ignoreativatewhenvisible OLEMISC_IGNOREACTIVATEWHENVISIBLE
wantstomenumerge OLEMISC_WANTSTOMENUMERGE
supportsmultilevelundo OLEMISC_SUPPORTSMULTILEVELUNDO

Typelib

Um subelemento de um elemento de arquivo . Opcional.

O elemento typelib tem os atributos mostrados na tabela a seguir.

Atributo Descrição
tlbid A ID exclusiva da biblioteca de tipos. Obrigatórios.
version O número de versão de duas partes da biblioteca de tipos. Se apenas o número de versão secundária aumentar, todos os recursos da biblioteca de tipos anteriores serão compatíveis. Se o número de versão principal for alterado, o código compilado na biblioteca de tipos deverá ser recompilado. O número de versão da biblioteca de tipos pode ser diferente do número de versão do aplicativo. Obrigatórios.
helpdir O diretório em que o arquivo de Ajuda para os tipos na biblioteca de tipos está localizado. Se o aplicativo der suporte a bibliotecas de tipos para vários idiomas, as bibliotecas poderão se referir a nomes de arquivo diferentes no diretório arquivo de Ajuda. Se nenhum valor, especifique "". Obrigatórios.
Resourceid A representação de cadeia de caracteres hexadecimal do LCID (identificador de localidade). É um a quatro dígitos hexadecimal sem prefixo 0x e sem zeros à esquerda. O LCID pode ter um identificador de sublinguagens de programação neutro. Para obter mais informações, consulte Identificadores de localidade. Opcional.
sinalizadores A representação de cadeia de caracteres dos sinalizadores de biblioteca de tipos para esta biblioteca de tipos. Especificamente, ele deve ser um entre "RESTRICTED", "CONTROL", "HIDDEN" e "HASDISKIMAGE". Esses são os valores da enumeração LIBFLAGS e são os mesmos sinalizadores especificados no parâmetro uLibFlags do método ICreateTypeLib::SetLibFlags . Opcional.

O exemplo a seguir mostra um elemento typelib incluído em um elemento de arquivo .

<file name="sampleu.dll">
       <typelib tlbid="{44EC0535-400F-11D0-9DCD-00A0C90391D3}"
       version="1.0" helpdir=""/>
</file>

comInterfaceExternalProxyStub

O comInterfaceExternalProxyStub é um subelemento de um elemento assembly e é usado para interfaces de automação. Por exemplo, IDispatch e suas interfaces derivadas. Opcional.

A implementação de proxy-stub padrão é adequada para a maioria das interfaces de automação, como interfaces derivadas de IDispatch. O stub do proxy de interface e todas as outras implementações de interface proxy-stub externas devem ser listados no comInterfaceExternalProxyStub. O elemento comInterfaceExternalProxyStub tem os atributos mostrados na tabela a seguir.

Atributo Descrição
iid A IID da interface para a qual o proxy está sendo declarado. Obrigatórios. O valor deve estar no formato: "{iid}".
Baseinterface O IID da interface da qual o descrito pelo atributo iid é derivado. Esse atributo é opcional. O valor deve estar no formato: "{iid}".
numMethods O número de métodos implementados pela interface. Esse atributo é opcional. O valor deve estar no formato: "n".
name Nome da interface como ela apareceria no código. Por exemplo, "IViewObject". Essa não deve ser uma cadeia de caracteres descritiva. Esse atributo é opcional. O valor deve estar no formato: "name".
tlbid A biblioteca de tipos que contém a descrição da interface especificada pelo atributo iid . Esse atributo é opcional. O valor deve estar no formato: "{tlbid}" .
proxyStubClsid32 Mapeia uma IID para uma CLSID em DLLs de proxy de 32 bits.

O exemplo a seguir mostra um elemento comInterfaceExternalProxyStub .

<comInterfaceExternalProxyStub 
  name="IAxWinAmbientDispatch" 
    iid="{B6EA2051-048A-11D1-82B9-00C04FB9942E}" 
    numMethods="35" 
  baseInterface="{00000000-0000-0000-C000-000000000046}"/>

comInterfaceProxyStub

Um subelemento de um elemento de arquivo . Opcional.

Se um arquivo no assembly implementar um stub de proxy, a marca de arquivo correspondente deverá incluir um subelemento comInterfaceProxyStub com atributos idênticos a um elemento comInterfaceProxyStub . O marshaling de interfaces entre processos e threads pode não funcionar conforme o esperado se você omitir algumas das dependências comInterfaceProxyStub do componente.

O elemento comInterfaceProxyStub tem os seguintes atributos.

Atributo Descrição
iid O. IID da interface para a qual o proxy está sendo declarado. Obrigatórios. O valor deve estar no formato: "{iid}".
name Nome da interface como ela apareceria no código. Por exemplo, "IViewObject". Essa não deve ser uma cadeia de caracteres descritiva. Esse atributo é opcional. O valor deve estar no formato: "name".
tlbid A biblioteca de tipos que contém a descrição da interface especificada pelo atributo iid . Esse atributo é opcional. O valor deve estar no formato: "{tlbid}".
Baseinterface O IID da interface da qual o descrito pelo atributo iid é derivado. Esse atributo é opcional. O valor deve estar no formato: "{iid}".
numMethods O número de métodos implementados pela interface. Esse atributo é opcional. O valor deve estar no formato: "n".
proxyStubClsid32 Mapeia uma IID para uma CLSID em DLLs de proxy de 32 bits.
Threadingmodel O modelo de threading usado por classes COM no processo. Se essa propriedade for nula, nenhum modelo de threading será usado. O componente é criado no thread principal do cliente e o marshaling de chamadas de outros threads é realizado para esse thread. Opcional. Os valores válidos são: "Apartment", "Free", "Both" e "Neutral".

Windowclass

O nome de uma classe windows que deve ser versão. O elemento windowclass tem o atributo a seguir.

Atributo Descrição
Versionado Esse atributo controla se o nome da classe de janela interna usado no registro contém ou não a versão do assembly que contém a classe de janela. O valor desse atributo pode ser "sim" ou "não". O padrão é "sim". O valor "não" só deverá ser usado se a mesma classe de janela for definida por um componente lado a lado e um componente não lado a lado equivalente e você desejar tratá-los como a mesma classe de janela. Observe que as regras usuais sobre o registro de classe de janela aplicam-se apenas ao primeiro componente que registra a classe de janela será capaz de registrá-la, pois ela não é versão.

O exemplo a seguir mostra um elemento windowclass incluído em um elemento de arquivo .

<file name="comctl32.dll">
        <windowClass versioned="no">ToolbarWindow32</windowClass>
</file>

Exemplo

Veja a seguir um exemplo de um manifesto do assembly.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" 
manifestVersion="1.0">
    <assemblyIdentity type="win32" name="Microsoft.Tools.SampleAssembly" version="6.0.0.0" processorArchitecture="x86" publicKeyToken="0000000000000000"/>
    <file name="sampleu.dll" hash="3eab067f82504bf271ed38112a4ccdf46094eb5a" hashalg="SHA1">
        <comClass description="Font Property Page" clsid="{0BE35200-8F91-11CE-9DE3-00AA004BB851}"/>
        <comClass description="Color Property Page" clsid="{0BE35201-8F91-11CE-9DE3-00AA004BB851}"/>
        <comClass description="Picture Property Page" clsid="{0BE35202-8F91-11CE-9DE3-00AA004BB851}"/>
    </file>
    <file name="bar.dll" hash="ac72753e5bb20446d88a48c8f0aaae769a962338" hashalg="SHA1"/>
    <file name="foo.dll" hash="a7312a1f6cfb46433001e0540458de60adcd5ec5" hashalg="SHA1">
        <comClass description="Registrar Class" clsid="{44EC053A-400F-11D0-9DCD-00A0C90391D3}" progid="ATL.Registrar"/>
    <comInterfaceProxyStub iid="{B6EA2051-048A-11D1-82B9-00C04FB9942E}" name=" IAxWinAmbientDispatch " tlbid="{34EC053A-400F-11D0-9DCD-00A0C90391D3}"/>
        <typelib tlbid="{44EC0535-400F-11D0-9DCD-00A0C90391D3}" version="1.0" helpdir=""/>
    </file>
    <file name="sampledll.dll" hash="ba62960ceb15073d2598379307aad84f3a73dfcb" hashalg="SHA1"/>
<windowClass>ToolbarWindow32</windowClass>
        <windowClass>ComboBoxEx32</windowClass>
        <windowClass>sample_trackbar32</windowClass>
        <windowClass>sample_updown32</windowClass>
</assembly>