<dependência>Elemento (aplicativo ClickOnce)

Artigo
08/25/2010

Identifica uma dependência de plataforma ou assembly é necessária para o aplicativo.

<dependency>
   <dependentOS
      supportURL
      description
   >
      <osVersionInfo>
         <os
            majorVersion
            minorVersion
            buildNumber
            servicePackMajor
            servicePackMinor
            productType
            suiteType
         /> 
      </osVersionInfo>
   </dependentOS>
   <dependentAssembly
      codeBase
      size
   >
      <assemblyIdentity
         name
         version
         processorArchitecture
         language
      >
         <hash>
            <dsig:Transforms>
               <dsig:Transform
                  Algorithm
            />
            </dsig:Transforms>
            <dsig:DigestMethod />
            <dsig:DigestValue>
            </dsig:DigestValue>
    </hash>

      </assemblyIdentity>
   </dependentAssembly>
</dependency>

Elementos e atributos

The dependency elemento é necessário. Pode haver várias instâncias de dependency no manifesto do aplicativo mesmo.

The dependency elemento não tiver atributos e contém os seguintes elementos filho.

dependentOS

Opcional. Contém o osVersionInfo elemento. The dependentOS e dependentAssembly elementos são mutuamente exclusivo: um ou Outros deve existir para um dependency elemento, mas não ambos.

dependentOS suporta os seguintes atributos.

Atributo	Descrição
supportUrl	Opcional. Especifica uma URL de suporte para a plataforma dependente. Essa URL é mostrado ao usuário se for encontrado obrigatórios da plataforma.
description	Opcional. Descreve, no formulário legível, o sistema operacional, descrito pelo dependentOS elemento.

osVersionInfo

Obrigatório. Este elemento é filho do dependentOS elemento e contém o os elemento. Este elemento possui sem atributos.

SO

Obrigatório. Este elemento é filho do osVersionInfo elemento. Este elemento tem os seguintes atributos.

Atributo	Descrição
majorVersion	Obrigatório. Especifica o número de versão principal do sistema operacional.
minorVersion	Obrigatório. Especifica o número de versão secundária do sistema operacional.
buildNumber	Obrigatório. Especifica o número da versão do sistema operacional.
servicePackMajor	Obrigatório. Especifica o service pack principais número do sistema operacional.
servicePackMinor	Opcional. Especifica o número da secundária serviço empacotar do sistema operacional.
productType	Opcional. Identifica o valor do tipo de produto. Os valores válido são server, workstation, e domainController. Por exemplo, para o Windows 2000 Professional, este valor de atributo é workstation.
suiteType	Opcional. Identifica um conjunto de produtos disponível no sistema ou o tipo de configuração do sistema. Os valores válido são backoffice, blade, datacenter, enterprise, home, professional, smallbusiness, smallbusinessRestricted, e terminal. Por exemplo, para o Windows 2000 Professional, este valor de atributo é professional.

dependentAssembly

Opcional. Contém o assemblyIdentity elemento. The dependentOS e dependentAssembly elementos são mutuamente exclusivo: um ou Outros deve existir para um dependency elemento, mas não ambos.

dependentAssembly tem os seguintes atributos.

Atributo	Descrição
`codeBase`	Obrigatório. O caminho para o assembly representado por este assembly. Pode ser um caminho absoluto ou um caminho relativo para código do manifesto base. Esse caminho também deve ser um URI válido para que o manifesto do assembly seja válido.
size	Obrigatório. O dimensionar do assembly dependente, em bytes.

assemblyIdentity

Obrigatório. Este elemento é filho do dependentAssembly elemento e tem os seguintes atributos.

Atributo	Descrição
name	Obrigatório. Identifica o nome do aplicativo.
version	Obrigatório. Especifica o número de versão do aplicativo no seguinte formato: Major.minor.compilação.Revision
publicKeyToken	Opcional. Especifica uma seqüência hexadecimal de 16 caractere que representa os últimos 8 bytes do SHA-1 valor de hash da chave pública na qual o aplicativo ou assembly é assinado. A chave pública usada para assinar o catálogo deve ser 2048 bits ou mais.
processorArchitecture	Opcional. Especifica o processador. Os valores válido são x86 para Windows de 32 bit e I64 para Windows de 64 bit.
language	Opcional. Identifica sistema autônomo códigos de linguagem dois parte, por exemplo, EN-US do assembly.

hash

The hash elemento é um filho opcional de assemblyIdentity elemento. The hash elemento tem sem atributos.

ClickOnce usa um hash algorítmico de todos sistema autônomo arquivos em um aplicativo sistema autônomo uma verificação de segurança para garantir que nenhum dos arquivos foram alterados após a implantação. Se o hash elemento não é incluído, essa verificação não será executada. Portanto, omitindo o hash elemento não é recomendado.

DSIG:Transforms

The dsig:Transforms elemento é um filho obrigatório o hash elemento. The dsig:Transforms elemento tem sem atributos.

DSIG:Transform

The dsig:Transform elemento é um filho obrigatório o dsig:Transforms elemento. The dsig:Transform elemento tem os seguintes atributos.

Atributo	Descrição
Algorithm	O algoritmo usado para calcular a compilação para este arquivo. Atualmente o único valor usado por ClickOnce é urn: schemas - microsoft - com:HashTransforms.identidade.

DSIG:DigestMethod

The dsig:DigestMethod elemento é um filho obrigatório o hash elemento. The dsig:DigestMethod elemento tem os seguintes atributos.

Atributo	Descrição
Algorithm	O algoritmo usado para calcular a compilação para este arquivo. Atualmente o único valor usado por ClickOnce é http://www.w3.org/2000/09/xmldsig#SHA1.

DSIG:DigestValue

The dsig:DigestValue elemento é um filho obrigatório o hash elemento. The dsig:DigestValue elemento tem sem atributos. Seu valor de texto é o hash calculado para o arquivo especificado.

Comentários

Todos os assemblies usados por seu aplicativo devem ter um correspondente dependency elemento. Assemblies dependentes não incluem sistema autônomo assemblies que pré-devem ser instalados no cache global de assemblies sistema autônomo assemblies da plataforma.

Exemplo

O exemplo de código a seguir ilustra dependency elementos em um ClickOnce manifesto do aplicativo. Este exemplo de código faz parte de um exemplo maior fornecido para o Manifesto de aplicativo ClickOnce tópico.

<!-- This XML identifies a SpellingChecker assembly. -->
<dependency>
  <dependentAssembly codebase="SpellingChecker.dll" size="29696">
    <assemblyIdentity name="SpellingChecker" version="2.0.0.0" publicKeyToken="e8ed396099c4b4e9" processorArchitecture="msil" language="es-PE" />
    <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>2+33lqQoPphgov907Kfp1v4TZMw=</dsig:DigestValue>
    </hash>
  </dependentAssembly>
</dependency>

<!-- This XML describes an operating system dependency for the application. -->
<!--Microsoft Windows Operating System Platform Dependency-->
<dependency>
  <dependentOS supportUrl="https://www.microsoft.com" description="Microsoft Windows Operating System">
    <osVersionInfo>
      <os majorVersion="4" minorVersion="10" />
    </osVersionInfo>
  </dependentOS>
</dependency>

Consulte também

Referência

Manifesto de aplicativo ClickOnce

Date	History	Motivo
Julho de 2008	Adicionadas informações opcionais sobre o hash elemento.	Aprimoramento de informações.

Julho de 2008

Adicionadas informações opcionais sobre o hash elemento.

Aprimoramento de informações.

Compartilhar via