次の方法で共有

<dependency> 要素 (ClickOnce アプリケーション)

  • [アーティクル]

更新 : 2008 年 7 月

アプリケーションに必須のプラットフォーム依存関係またはアセンブリ依存関係を識別します。

<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>

要素および属性

dependency 要素は必須です。同じアプリケーション マニフェストに dependency のインスタンスが複数存在してもかまいません。

dependency 要素は属性がなく、次の子要素を含みます。

dependentOS

省略できます。osVersionInfo 要素を含みます。dependentOS 要素と dependentAssembly 要素は相互に排他的です。dependency 要素にはいずれか一方が必要ですが、両方は指定できません。

dependentOS は、以下の属性をサポートします。

属性

説明

supportUrl

省略できます。依存関係にあるプラットフォームのサポート URL を指定します。必要なプラットフォームが見つかると、この URL がユーザーに表示されます。

description

省略できます。dependentOS 要素に記述したオペレーティング システムについて、ユーザーが認識できる形式で記述します。

osVersionInfo

必ず指定します。この要素は dependentOS 要素の子であり、os 要素が含まれています。この要素に属性はありません。

os

必ず指定します。この要素は osVersionInfo 要素の子です。この要素には、次の属性があります。

属性

説明

majorVersion

必ず指定します。OS のメジャー バージョン番号を指定します。

minorVersion

必ず指定します。OS のマイナ バージョン番号を指定します。

buildNumber

必ず指定します。OS のビルド番号を指定します。

servicePackMajor

必ず指定します。OS のサービス パックのメジャー番号を指定します。

servicePackMinor

省略できます。OS のサービス パックのマイナ番号を指定します。

productType

省略できます。製品の種類を識別します。有効値は server、workstation、および domainController です。たとえば、Windows 2000 Professional の場合、この属性は workstation です。

suiteType

省略できます。システムで使用できる製品スイート、またはシステムの構成の種類を識別します。有効値は、backoffice、blade、datacenter、enterprise、home、professional、smallbusiness、smallbusinessRestricted、および terminal です。たとえば、Windows 2000 Professional の場合、この属性は professional です。

dependentAssembly

省略できます。assemblyIdentity 要素を含みます。dependentOS 要素と dependentAssembly 要素は相互に排他的です。dependency 要素にはいずれか一方が必要ですが、両方は指定できません。

dependentAssembly には、以下の属性があります。

属性

説明

 
codeBase

必ず指定します。このアセンブリで表されるアセンブリのパスです。絶対パスまたはマニフェストのコード ベースに対する相対パスで指定します。アセンブリ マニフェストが有効であるためには、このパスが有効な URI であることが必要です。

size

必ず指定します。依存関係のアセンブリのサイズ (バイト単位) です。

assemblyIdentity

必ず指定します。この要素は dependentAssembly 要素の子であり、以下の属性があります。

属性

説明

name

必ず指定します。アプリケーションの名前を識別します。

version

必ず指定します。major.minor.build.revision の形式で、アプリケーションのバージョン番号を指定します。

publicKeyToken

省略できます。アプリケーションまたはアセンブリに署名するために使用する公開キーの SHA-1 ハッシュ値のうち、最後の 8 バイトを表す 16 文字の 16 進文字列を指定します。カタログに署名するために使用する公開キーは、2048 ビット以上である必要があります。

processorArchitecture

省略できます。プロセッサを指定します。有効な値は、32 ビット Windows の場合 x86、64 ビット Windows の場合 I64 です。

language

省略できます。EN-US など 2 つの部分から構成されるアセンブリの言語コードを識別します。

hash

hash 要素は、assemblyIdentity 要素の子要素で、省略可能です。hash 要素に属性はありません。

ClickOnce では、セキュリティをチェックするために、アプリケーション内の全ファイルで計算したハッシュを使用して、配置後にどのファイルも変更されていないことを確認できるようにしています。hash 要素が含まれていない場合、このチェックは実行されません。したがって、hash 要素を省略することは推奨できません。

dsig:Transforms

dsig:Transforms 要素は、hash 要素に必須の子です。dsig:Transforms 要素に属性はありません。

dsig:Transform

dsig:Transform 要素は、dsig:Transforms 要素に必須の子です。dsig:Transform 要素には、次の属性があります。

属性

説明

Algorithm

このファイルのダイジェストを計算するために使用するアルゴリズムです。ClickOnce が現在使用している唯一の値は、urn:schemas-microsoft-com:HashTransforms.Identity です。

dsig:DigestMethod

dsig:DigestMethod 要素は、hash 要素に必須の子です。dsig:DigestMethod 要素には、次の属性があります。

属性

説明

Algorithm

このファイルのダイジェストを計算するために使用するアルゴリズムです。ClickOnce が現在使用している唯一の値は、http://www.w3.org/2000/09/xmldsig#sha1 です。

dsig:DigestValue

dsig:DigestValue 要素は、hash 要素に必須の子です。dsig:DigestValue 要素に属性はありません。このテキスト値は、指定のファイルで計算されたハッシュです。

解説

アプリケーションで使用するすべてのアセンブリには、対応する dependency 要素が必要です。プラットフォーム アセンブリとしてグローバル アセンブリ キャッシュにプレインストールする必要のあるアセンブリは、依存関係のアセンブリには含まれません。

使用例

次のコード例は、ClickOnce アプリケーション マニフェスト内の dependency 要素を示しています。このコード例は、「ClickOnce アプリケーション マニフェスト」トピックで提供されているより詳細な例の一部です。

<!-- 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>

参照

参照

ClickOnce アプリケーション マニフェスト

履歴の変更

日付

履歴

理由

2008 年 7 月

hash 要素の省略に関する情報を追加

情報の拡充