<InstallChecks> 要素 (ClickOnce ブートストラップ)

更新 : 2007 年 11 月

InstallChecks 要素は、ClickOnce アプリケーションのための適切な必須コンポーネントがローカル コンピュータにインストール済みであるかどうかを確認する各種テストの起動をサポートします。

<InstallChecks>
    <AssemblyCheck 
        Property
        Name
        PublicKeyToken
        Version
        Language
        ProcessorArchitecture
    />
    <RegistryCheck
        Property
        Key
        Value
    />
    <ExternalCheck 
        PackageFile
        Property
        Arguments
    />
    <FileCheck 
        Property
        FileName
        SearchPath
        SpecialFolder
        SearchDepth
    />
    <MsiProductCheck 
        Property
        Product
        Feature
    />
    <RegistryFileCheck 
        Property
        Key
        Value
        File
        SearchDepth
    />
</InstallChecks>

AssemblyCheck

この要素は、InstallChecks の子要素で、省略可能です。ブートストラップは、AssemblyCheck の各インスタンスについて、この要素で指定されたアセンブリがグローバル アセンブリ キャッシュ (GAC) に存在するかどうかを確認します。要素はなく、次の属性を持ちます。

ExternalCheck

この要素は、InstallChecks の子要素で、省略可能です。ブートストラップでは、ExternalCheck のインスタンスごとに、指定された外部プログラムを別々のプロセスで実行し、その終了コードを Property で指定されたプロパティに格納します。複雑な依存関係のチェック処理を実装する場合や、コンポーネントが存在するかどうかを確認するためにコンポーネントをインストールするしか方法がない場合には、ExternalCheck が便利です。

ExternalCheck に要素はなく、次の属性を持ちます。

FileCheck

この要素は、InstallChecks の子要素で、省略可能です。ブートストラップでは、FileCheck のインスタンスごとに、指定されたファイルが存在するかどうかを確認し、ファイルのバージョン番号を返します。ファイルにバージョン番号がない場合、Property で指定したプロパティには 0 が設定されます。ファイルが存在しない場合、Property には、値が設定されません。

FileCheck に要素はなく、次の属性を持ちます。

MsiProductCheck

この要素は、InstallChecks の子要素で、省略可能です。ブートストラップでは、MsiProductCheck のインスタンスごとに、指定された Microsoft Windows インストーラのインストールが最後まで実行されているかどうかを確認します。プロパティ値は、製品のインストール状態に基づいて設定されます。正の値は製品がインストールされていることを示し、0 または -1 はインストールされていないことを示します (詳細については、Windows インストーラ SDK の MsiQueryFeatureState 関数を参照してください)。Windows インストーラがコンピュータにインストールされていない場合は、Property が設定されません。

MsiProductCheck に要素はなく、次の属性を持ちます。

RegistryCheck

この要素は、InstallChecks の子要素で、省略可能です。ブートストラップでは、RegistryCheck のインスタンスごとに、指定されたレジストリ キーが存在するかどうか、または、そのレジストリ キーに指定された値が設定されているかどうかを確認します。

RegistryCheck に要素はなく、次の属性を持ちます。

RegistryFileCheck

この要素は、InstallChecks の子要素で、省略可能です。ブートストラップでは、RegistryFileCheck のインスタンスごとに、指定されたレジストリ キーからファイルのパスを取得し、指定されたファイルのバージョンを取得します。この機能は、検索対象のファイルを格納してあるディレクトリが、レジストリ内に値として指定されている場合に、特に便利です。

RegistryFileCheck に要素はなく、次の属性を持ちます。

解説

実行するテストは、InstallChecks の子要素に定義しますが、これらの子要素でテストが実行されるわけではありません。テストを実行するには、Commands 要素の下に Command 要素を作成する必要があります。

使用例

次のコード例は、.NET Framework の製品ファイルで使用する場合の InstallChecks 要素を示しています。

<InstallChecks>
    <ExternalCheck Property="DotNetInstalled" PackageFile="dotnetchk.exe" />
    <RegistryCheck Property="IEVersion" Key="HKLM\Software\Microsoft\Internet Explorer" Value="Version" />
</InstallChecks>

InstallConditions

InstallChecks が評価されると、プロパティが生成されます。これらのプロパティは InstallConditions で使用され、パッケージをインストールするか、バイパスするか、またはパッケージが失敗するかが判断されます。次の表は、InstallConditions の一覧です。

定義済みプロパティ

ブートストラップは、InstallIf で使用される次のプロパティを自動的に定義します。次の表は、BypassIf 要素と FailIf 要素の一覧です。

たとえば、Windows 95 コンピュータへのインストールをブロックするには、次のようなコードを使用します。

<!-- Block install on Win95 -->
    <FailIf Property="Version9X" Compare="VersionLessThan" Value="4.10" String="InvalidPlatform"/>

参照

参照

<Commands> 要素 (ClickOnce ブートストラップ)

製品およびパッケージ スキーマ リファレンス