Guide pratique pour définir les numéros de version XML HelpInfo

Cette rubrique explique comment définir et augmenter les numéros de version dans un fichier d’informations d’aide pouvant être mis à jour, communément appelé « fichier XML HelpInfo ».

Guide pratique pour définir les numéros de version XML HelpInfo

Les numéros de version d’un fichier XML HelpInfo sont essentiels au fonctionnement de l’aide actualisable. Les applets de commande Update-Help et Save-Help téléchargent de nouveaux fichiers d’aide uniquement lorsque le numéro de version d’une culture d’interface utilisateur dans le fichier XML HelpInfo distant est supérieur au numéro de version de cette culture d’interface utilisateur dans le XML HelpInfo local, ou qu’il n’existe aucun fichier XML HelpInfo local.

Le fichier XML HelpInfo utilise le numéro de version en 4 parties qui est défini dans la classe System. version de l' .NET Framework Microsoft. Le format est N1.N2.N3.N4. Les auteurs de modules peuvent utiliser n’importe quel modèle de numérotation de version qui est autorisé par la classe System. version . L’aide actualisable nécessite uniquement que le numéro de version d’une culture d’interface utilisateur augmente lorsqu’une nouvelle version du fichier CAB pour cette culture d’interface utilisateur est téléchargée vers l’emplacement spécifié par l’élément HelpContentURI dans le fichier XML HelpInfo.

L’exemple suivant montre les éléments du fichier XML HelpInfo pour la culture d’interface utilisateur allemande (de-DE) lorsque la version est 2.15.0.10.

<UICulture>
  <UICultureName>de-DE</UICultureName>
  <UICultureVersion>2.15.0.10</UICultureVersion>
</UICulture>

Le numéro de version d’une culture d’interface utilisateur reflète la version du fichier CAB pour cette culture d’interface utilisateur. Le numéro de version s’applique à l’ensemble du fichier CAB. Vous ne pouvez pas définir des numéros de version différents pour différents fichiers dans le fichier CAB. Le numéro de version de chaque culture d’interface utilisateur est évalué indépendamment et n’a pas besoin d’être lié aux numéros de version des autres cultures d’interface utilisateur prises en charge par le module.