<PackageFiles>, élément (programme d'amorçage)

Article
06/10/2015

L'élément PackageFiles contient les éléments PackageFile qui définissent les packages d'installation exécutés à la suite de l'élément Command.

<PackageFiles
    CopyAllPackageFiles
>
    <PackageFile 
        Name
        HomeSite
        CopyOnBuild
        PublicKey
        Hash
    />
</PackageFiles>

Éléments et attributs

L'élément PackageFiles a l'attribut suivant.

Attribut	Description
CopyAllPackageFiles	Facultatif. S'il a la valeur false, le programme d'installation ne télécharge que les fichiers référencés à partir de l'élément Command. S'il a la valeur true, tous les fichiers sont téléchargés. S'il a la valeur IfNotHomesite, le programme d'installation se comporte comme avec la valeur False si ComponentsLocation a la valeur HomeSite ; sinon, il se comporte comme avec la valeur True. Ce paramètre peut permettre aux packages qui sont eux-mêmes des programmes d'amorçage d'exécuter leur propre comportement dans un scénario HomeSite. La valeur par défaut est true.

CopyAllPackageFiles

Facultatif. S'il a la valeur false, le programme d'installation ne télécharge que les fichiers référencés à partir de l'élément Command. S'il a la valeur true, tous les fichiers sont téléchargés.

S'il a la valeur IfNotHomesite, le programme d'installation se comporte comme avec la valeur False si ComponentsLocation a la valeur HomeSite ; sinon, il se comporte comme avec la valeur True. Ce paramètre peut permettre aux packages qui sont eux-mêmes des programmes d'amorçage d'exécuter leur propre comportement dans un scénario HomeSite.

La valeur par défaut est true.

PackageFile

L'élément PackageFile est un enfant de l'élément PackageFiles. Un élément PackageFiles doit avoir au moins un élément PackageFile.

PackageFile possède les attributs suivants.

Attribut	Description
Name	Obligatoire. Nom du fichier de package. Il s'agit du nom que l'élément Command référence lorsqu'il définit les conditions d'installation d'un package. Cette valeur est également utilisée comme clé dans la table Strings pour extraire le nom localisé utilisé par des outils tels que Visual Studio pour décrire le package.
HomeSite	Facultatif. Emplacement du package sur le serveur distant, s'il n'est pas inclus avec le programme d'installation.
CopyOnBuild	Facultatif. Spécifie si le programme d'amorçage doit copier le fichier de package sur le disque au moment de la génération. La valeur par défaut est true.
PublicKey	Clé publique chiffrée du signataire de certificat du package. Obligatoire si HomeSite est utilisé ; sinon il est facultatif.
Hash	Facultatif. Hachage SHA1 du fichier de package. Il est utilisé pour vérifier l'intégrité du fichier au moment de l'installation. Si le hachage identique ne peut pas être calculé à partir du fichier de package, le package ne sera pas installé.

Exemple

L'exemple de code suivant définit des packages pour le package redistribuable du .NET Framework et de ses dépendances, telles que Windows Installer.

    <PackageFiles>
        <PackageFile Name="instmsia.exe" HomeSite="InstMsiAExe" PublicKey="3082010A0282010100AA99BD39A81827F42B3D0B4C3F7C772EA7CBB5D18C0DC23A74D793B5E0A04B3F595ECE454F9A7929F149CC1A47EE55C2083E1220F855F2EE5FD3E0CA96BC30DEFE58C82732D08554E8F09110BBF32BBE19E5039B0B861DF3B0398CB8FD0B1D3C7326AC572BCA29A215908215E277A34052038B9DC270BA1FE934F6F335924E5583F8DA30B620DE5706B55A4206DE59CBF2DFA6BD154771192523D2CB6F9B1979DF6A5BF176057929FCC356CA8F440885558ACBC80F464B55CB8C96774A87E8A94106C7FF0DE968576372C36957B443CF323A30DC1BE9D543262A79FE95DB226724C92FD034E3E6FB514986B83CD0255FD6EC9E036187A96840C7F8E203E6CF050203010001"/>
        <PackageFile Name="WindowsInstaller-KB884016-v2-x86.exe" HomeSite="Msi30Exe" PublicKey="3082010A0282010100B22D8709B55CDF5599EB5262E7D3F4E34571A932BF94F20EE90DADFE9DC7046A584E9CA4D1D84441FB647E0F65EEC817DA4DDBD9D650B40C565B6C16884BBF03EE504883EC4F88939A51E394197FFAB397A5CE606D9FDD4C9338BDCD345971E686CEE98399A096B8EAE0445B1342B93A484E5472F70896E400C482017643AF61C2DBFAE5C5F00213DDF835B40F0D5236467443B1A2CA9CDD7E99F1351177FB1526018ECFE0B804782A15FD72C66076910CE74FB218181B6989B4F12F211B66EACA91C7460DB91758715856866523D10232AE64A06FDA5295FDFBDD8D34F5C10C35A347D7E91B6AFA0F45B4E8321D7019BDD1F9E5641FEB8737EA6FD40D838FFD0203010001"/>
        <PackageFile Name="dotnetfx.exe" HomeSite="DotNetFXExe" PublicKey="3082010A0282010100B22D8709B55CDF5599EB5262E7D3F4E34571A932BF94F20EE90DADFE9DC7046A584E9CA4D1D84441FB647E0F65EEC817DA4DDBD9D650B40C565B6C16884BBF03EE504883EC4F88939A51E394197FFAB397A5CE606D9FDD4C9338BDCD345971E686CEE98399A096B8EAE0445B1342B93A484E5472F70896E400C482017643AF61C2DBFAE5C5F00213DDF835B40F0D5236467443B1A2CA9CDD7E99F1351177FB1526018ECFE0B804782A15FD72C66076910CE74FB218181B6989B4F12F211B66EACA91C7460DB91758715856866523D10232AE64A06FDA5295FDFBDD8D34F5C10C35A347D7E91B6AFA0F45B4E8321D7019BDD1F9E5641FEB8737EA6FD40D838FFD0203010001"/>
        <PackageFile Name="dotnetchk.exe"/>
    </PackageFiles>

Voir aussi

Référence

<Product>, élément (programme d'amorçage)

<Package>, élément (programme d'amorçage)

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

Partager via