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

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

<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
        FileName
        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 の一覧です。

定義済みプロパティ

次の表は、BypassIf 要素および FailIf 要素の一覧です。

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

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

参照

参照

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

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