<InstallChecks>, élément (Programme d'amorçage de ClickOnce)

Article
08/21/2008

Mise à jour : novembre 2007

L'élément InstallChecks prend en charge le lancement de divers tests sur l'ordinateur local pour s'assurer que tous les composants requis appropriés pour une application ClickOnce ont été installés.

<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

Cet élément est un élément enfant facultatif de InstallChecks. Pour chaque instance de AssemblyCheck, le programme d'amorçage vérifie que l'assembly identifié par l'élément existe dans le Global Assembly Cache (GAC). Il ne contient pas d'éléments et possède les attributs suivants.

Attribut	Description
Property	Obligatoire. Nom de la propriété pour stocker le résultat. Cette propriété peut être référencée à partir d'un test sous l'élément InstallConditions, qui est un enfant de l'élément Command. Pour plus d'informations, consultez <Commands>, élément (Programme d'amorçage de ClickOnce).
Name	Obligatoire. Nom complet de l'assembly à vérifier.
PublicKeyToken	Obligatoire. Forme abrégée de la clé publique associée à cet assembly avec nom fort. Tous les assemblys stockés dans le GAC doivent avoir un nom, une version et une clé publique.
Version	Obligatoire. Version de l'assembly. Le numéro de version a le format <version principale>. <version secondaire>. <version de build>. <version de révision>.
Language	Facultatif. Langue d'un assembly localisé. La valeur par défaut est neutral.
ProcessorArchitecture	Facultatif. Processeur informatique ciblé par cette installation. La valeur par défaut est msil.

ExternalCheck

Cet élément est un élément enfant facultatif de InstallChecks. Pour chaque instance de ExternalCheck, le programme d'amorçage exécute le programme externe nommé dans un processus distinct et stocke son code de sortie dans la propriété indiquée par Property. ExternalCheck est utile pour mettre en œuvre des contrôles de dépendance complexes, ou lorsque la seule méthode pour vérifier l'existence d'un composant est de l'instancier.

ExternalCheck ne contient pas d'éléments et a les attributs suivants.

Attribut	Description
Property	Obligatoire. Nom de la propriété pour stocker le résultat. Cette propriété peut être référencée à partir d'un test sous l'élément InstallConditions, qui est un enfant de l'élément Command. Pour plus d'informations, consultez <Commands>, élément (Programme d'amorçage de ClickOnce).
PackageFile	Obligatoire. Programme externe à exécuter. Le programme doit faire partie du package de distribution de l'installation.
Arguments	Facultatif. Fournit des arguments de ligne de commande à l'exécutable nommé par PackageFile.

FileCheck

Cet élément est un élément enfant facultatif de InstallChecks. Pour chaque instance de FileCheck, le programme d'amorçage détermine si le fichier nommé existe et retourne le numéro de version du fichier. Si le fichier n'a pas de numéro de version, le programme d'amorçage affecte la valeur 0 à la propriété nommée par Property. Si le fichier n'existe pas, aucune valeur n'est définie pour Property.

FileCheck ne contient pas d'éléments et a les attributs suivants.

Attribut	Description
Property	Obligatoire. Nom de la propriété pour stocker le résultat. Cette propriété peut être référencée à partir d'un test sous l'élément InstallConditions, qui est un enfant de l'élément Command. Pour plus d'informations, consultez <Commands>, élément (Programme d'amorçage de ClickOnce).
FileName	Obligatoire. Nom du fichier à rechercher.
SearchPath	Obligatoire. Disque ou dossier dans lequel rechercher le fichier. Il doit s'agir d'un chemin d'accès relatif si SpecialFolder est assigné ; sinon ce chemin doit être un chemin d'accès absolu.
SpecialFolder	Facultatif. Dossier qui a une signification spéciale pour Windows ou ClickOnce. Par défaut, SearchPath est interprété comme un chemin d'accès absolu. Les valeurs valides incluent les suivantes : AppDataFolder. Dossier Application Data de cette application ClickOnce, spécifique à l'utilisateur actuel. CommonAppDataFolder. Dossier Application Data utilisé par tous les utilisateurs. CommonFilesFolder. Dossier Fichiers communs de l'utilisateur actuel. LocalDataAppFolder. Dossier de données pour des applications non itinérantes. ProgramFilesFolder. Dossier Program Files standard pour les applications 32 bits. StartUpFolder. Dossier qui contient toutes les applications lancées au démarrage du système. SystemFolder. Dossier qui contient des DLL de système 32 bits. WindowsFolder. Dossier qui contient l'installation du système Windows. WindowsVolume. Lecteur ou partition qui contient l'installation du système Windows.
SearchDepth	Facultatif. Profondeur de la recherche du fichier nommé dans les sous-dossiers. Il s'agit d'une recherche en profondeur. La valeur par défaut, 0, limite la recherche au dossier à la racine spécifié par SpecialFolder et SearchPath.

MsiProductCheck

Cet élément est un élément enfant facultatif de InstallChecks. Pour chaque instance de MsiProductCheck, le programme d'amorçage vérifie si l'installation Microsoft Windows Installer spécifiée s'est terminée correctement. La valeur de propriété est définie selon l'état du produit installé. Une valeur positive indique que le produit est installé ; la valeur 0 ou -1 indique qu'il n'est pas installé. (Pour plus d'informations, reportez-vous à la fonction MsiQueryFeatureState du Kit de développement Windows Installer.) . Si Windows Installer n'est pas installé sur l'ordinateur, Property n'est pas défini.

MsiProductCheck ne contient pas d'éléments et a les attributs suivants.

Attribut	Description
Property	Obligatoire. Nom de la propriété pour stocker le résultat. Cette propriété peut être référencée à partir d'un test sous l'élément InstallConditions, qui est un enfant de l'élément Command. Pour plus d'informations, consultez <Commands>, élément (Programme d'amorçage de ClickOnce).
Product	Obligatoire. GUID du produit installé.
Feature	Facultatif. GUID d'une fonctionnalité spécifique de l'application installée.

RegistryCheck

Cet élément est un élément enfant facultatif de InstallChecks. Pour chaque instance de RegistryCheck, le programme d'amorçage vérifie si la clé de Registre spécifiée existe, ou si elle a la valeur indiquée.

RegistryCheck ne contient pas d'éléments et a les attributs suivants.

Attribut	Description
Property	Obligatoire. Nom de la propriété pour stocker le résultat. Cette propriété peut être référencée à partir d'un test sous l'élément InstallConditions, qui est un enfant de l'élément Command. Pour plus d'informations, consultez <Commands>, élément (Programme d'amorçage de ClickOnce).
Key	Obligatoire. Nom de la clé de Registre.
Value	Facultatif. Nom de la clé de Registre à récupérer. Par défaut, retourne le texte de la valeur par défaut. Value doit être une chaîne ou une valeur DWORD.

RegistryFileCheck

Cet élément est un élément enfant facultatif de InstallChecks. Pour chaque instance de RegistryFileCheck, le programme d'amorçage extrait la version du fichier spécifié, en essayant d'abord de récupérer le chemin d'accès au fichier à partir de la clé de Registre spécifiée. Ceci est particulièrement utile si vous souhaitez rechercher un fichier dans un répertoire spécifié comme une valeur dans le Registre.

RegistryFileCheck ne contient pas d'éléments et a les attributs suivants.

Attribut	Description
Property	Obligatoire. Nom de la propriété pour stocker le résultat. Cette propriété peut être référencée à partir d'un test sous l'élément InstallConditions, qui est un enfant de l'élément Command. Pour plus d'informations, consultez <Commands>, élément (Programme d'amorçage de ClickOnce).
Key	Obligatoire. Nom de la clé de Registre. Sa valeur est interprétée comme le chemin d'accès à un fichier, à moins que l'attribut File soit défini. Si la clé n'existe pas, Property n'est pas défini.
Value	Facultatif. Nom de la clé de Registre à récupérer. Par défaut, retourne le texte de la valeur par défaut. Value doit être une chaîne.
File	Facultatif. Nom d'un fichier. S'il est spécifié, la valeur obtenue de la clé de Registre est supposée être un chemin d'accès au répertoire et ce nom lui est ajouté. S'il ne l'est pas, la valeur retournée par le Registre est supposée représenter le chemin d'accès complet à un fichier.
SearchDepth	Facultatif. Profondeur de la recherche du fichier nommé dans les sous-dossiers. Il s'agit d'une recherche en profondeur. La valeur par défaut, 0, limite la recherche au dossier à la racine spécifié par la valeur de la clé de Registre.

Notes

Si les éléments sous InstallChecks définissent les tests à exécuter, en revanche, ils ne les exécutent pas. Pour exécuter les tests, vous devez créer des éléments Command sous l'élément Commands.

Exemple

L'exemple de code suivant illustre l'utilisation de l'élément InstallChecks dans le fichier produit du .NET Framework.

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

InstallConditions

Lorsque l'élément InstallChecks est évalué, il produit des propriétés. Elles sont ensuite utilisées par InstallConditions pour déterminer si un package doit être installé, ignoré ou en échec. Le tableau suivant décrit InstallConditions :

InstallIf	Toutes les conditions InstallIf doivent prendre la valeur True pour installer le composant. Si une ou plusieurs conditions InstallIf prennent la valeur False, le composant sera ignoré. Aucune autre condition ne sera évaluée.
FailIf	Si une condition FailIf prend la valeur True, le package échouera. Le reste des conditions ne sera pas évalué. Le package échouera même si un ou plusieurs contrôles InstallIf prennent la valeur True.
BypassIf	Si une condition BypassIf prend la valeur True, le package sera ignoré. Le reste des conditions ne sera pas évalué. Le package sera ignoré même si un ou plusieurs contrôles InstallIf prennent la valeur True.

Propriétés prédéfinies

Le programme d'amorçage définira automatiquement les propriétés suivantes qu'utilisera InstallIf. Le tableau suivant répertorie les éléments BypassIf et FailIf :

Propriété	Remarques	Valeurs possibles
Version9X	Numéro de version d'un système d'exploitation Windows 9X.	4.10 = Windows 98
VersionNT	Numéro de version d'un système d'exploitation basé sur Windows NT.	Major.Minor.ServicePack 5.0 = Windows 2000 5.1.0 = Windows XP 5.1.2 = Windows XP Professionnel SP2 5.2.0 = Windows Server 2003
VersionNT64	Numéro de version d'un système d'exploitation basé sur Windows NT 64 bits.	Comme mentionné précédemment.
VersionMsi	Numéro de version du service Windows Installer.	2.0 = Windows Installer 2.0
AdminUser	Spécifie si un utilisateur a des privilèges d'administrateur sur un système d'exploitation basé sur Windows NT.	0 = aucun privilège d'administrateur 1 = privilèges d'administrateur

Par exemple, pour bloquer l'installation sur un ordinateur Windows 95, utilisez du code comme le suivant :

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

Voir aussi

Référence

<Commands>, élément (Programme d'amorçage de ClickOnce)

Référence du schéma de produit et de package

Share via