<dependency> 要素 (ClickOnce 配置)

インストールするアプリケーションのバージョンおよびアプリケーション マニフェストの場所を指定します。

<dependency> 
   <dependentAssembly
      preRequisite
      visible
      dependencyType
      codeBase
      size
   > 
      <assemblyIdentity 
         name 
         version 
         publicKeyToken 
         processorArchitecture 
         language
         type
      /> 
      <hash>
         <dsig:Transforms>
            <dsig:Transform
                Algorithm
            />
         </dsig:Transforms>
         <dsig:DigestMethod />
         <dsig:DigestValue>
         </dsig:DigestValue>
      </hash>

   </dependentAssembly> 
</dependency>

要素と属性

dependency 要素は必須です。 属性はありません。 配置マニフェストは、複数の dependency 要素を持つことができます。

dependency 要素では、通常、ClickOnce アプリケーションに含まれるメイン アプリケーションのアセンブリに対する依存関係を表します。 Main.exe アプリケーションで DotNetAssembly.dll アセンブリを使用している場合は、このアセンブリを依存関係セクションにリスト アップする必要があります。 また、共通言語ランタイムの特定のバージョンへの依存関係や、グローバル アセンブリ キャッシュ (GAC: Global Assembly Cache) にあるアセンブリへの依存関係、COM オブジェクトへの依存関係など、他の種類の依存関係も記述できます。 ClickOnce 配置テクノロジでは、手動による操作は行われないため、このような種類の依存関係をダウンロードしたりインストールしたりすることはできません。ただし、指定した依存対象が存在しない場合に、アプリケーションが実行されないようにすることはできます。

dependentAssembly

必ず指定します。 この要素には、assemblyIdentity 要素が含まれています。 dependentAssembly でサポートされている属性を次の表に示します。

assemblyIdentity

必ず指定します。 この要素は dependentAssembly 要素の子です。 assemblyIdentity の内容は、ClickOnce アプリケーション マニフェストの記述内容と一致している必要があります。 次の表に assemblyIdentity 要素の属性を示します。

hash

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

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

dsig:Transforms

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

dsig:Transform

dsig:Transform 要素は、dsig:Transforms 要素に必須の子です。 dsig:Transform 要素の属性を次の表に示します。

dsig:DigestMethod

dsig:DigestMethod 要素は、hash 要素に必須の子です。 dsig:DigestMethod 要素の属性を次の表に示します。

dsig:DigestValue

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

解説

配置マニフェストは通常、アプリケーション マニフェストの名前とバージョンを指定した assemblyIdentity 要素を 1 つ持ちます。

使用例

ClickOnce 配置マニフェスト内の dependency 要素を次のコード例に示します。

<!-- Identify the assembly dependencies -->
<dependency>
  <dependentAssembly dependencyType="install" allowDelayedBinding="true" codebase="MyApplication.exe" size="16384">
    <assemblyIdentity name="MyApplication" version="0.0.0.0" cultural="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>YzXYZJAvj9pgAG3y8jXUjC7AtHg=</dsig:DigestValue>
    </hash>
  </dependentAssembly>
</dependency>

次のコード例では、既に GAC にインストールされているアセンブリへの依存関係を指定しています。

<dependency>
  <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true">
    <assemblyIdentity name="GACAssembly" version="1.0.0.0" language="neutral" processorArchitecture="msil" />
  </dependentAssembly>
</dependency>

次のコード例では、共通言語ランタイムの特定のバージョンへの依存関係を指定しています。

<dependency>
  <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true">
    <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="2.0.50215.0" />
  </dependentAssembly>
</dependency>

次のコード例では、特定のオペレーティング システムへの依存関係を指定しています。

<dependency>
   <dependentOS supportUrl="https://www.microsoft.com" description="Microsoft Windows Operating System">
      <osVersionInfo>
         <os majorVersion="4" minorVersion="10" />
      </osVersionInfo>
   </dependentOS>
</dependency>

参照

参照

ClickOnce 配置マニフェスト

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