Élément <file> (application ClickOnce)

Article
03/22/2023

Identifie tous les fichiers hors assembly qui sont téléchargés et utilisés par l’application.

Syntax

<file
    name
    size
    group
    optional
    writeableType
>
    <typelib
        tlbid
        version
        helpdir
        resourceid
        flags
    />
    <comClass
        clsid
        description
        threadingModel
        tlbid
        progid
        miscStatus
        miscStatusIcon
        miscStatusContent
        miscStatusDocPrint
        miscStatusThumbnail
    />
    <comInterfaceExternalProxyStub
        iid
        baseInterface
        numMethods
        name
        tlbid
        proxyStubClass32
    />
    <comInterfaceProxyStub
        iid
        baseInterface
        numMethods
        name
        tlbid
        proxyStubClass32
    />
    <windowClass
        versioned
    />
</file>

Éléments et attributs

L’élément file est facultatif. L’élément a les attributs suivants.

Attribut	Description
`name`	Obligatoire. Identifie le nom du fichier.
`size`	Obligatoire. Spécifie la taille, en octets, du fichier.
`group`	Facultatif si l’attribut `optional` n’est pas spécifié ou est défini sur `false` ; obligatoire si `optional` est `true`. Nom du groupe auquel appartient ce fichier. Le nom peut être n’importe quelle valeur de chaîne Unicode choisie par le développeur. Il est utilisé pour télécharger des fichiers à la demande avec la classe ApplicationDeployment.
`optional`	facultatif. Spécifie si ce fichier doit être téléchargé lors de la première exécution de l’application ou si le fichier doit résider uniquement sur le serveur jusqu’à ce que l’application en fasse la demande. Si l’attribut est `false` ou n’est pas défini, le fichier est téléchargé lors de la première exécution ou installation de l’application. Si l’attribut est `true`, une valeur `group` doit être spécifiée pour que le manifeste de l’application soit valide. `optional` ne peut pas avoir la valeur true si `writeableType` est spécifié avec la valeur `applicationData`.
`writeableType`	facultatif. Spécifie que ce fichier est un fichier de données. Actuellement, la seule valeur valide est `applicationData`.

typelib

L’élément typelib est un enfant facultatif de l’élément file. L’élément décrit la bibliothèque de types qui appartient au composant COM. L’élément a les attributs suivants.

Attribut	Description
`tlbid`	Obligatoire. GUID attribué à la bibliothèque de types.
`version`	Obligatoire. Numéro de version de la bibliothèque de types.
`helpdir`	Obligatoire. Répertoire qui contient les fichiers d’aide du composant. Peut être de longueur nulle.
`resourceid`	facultatif. Représentation sous forme de chaîne hexadécimale de l’identificateur de paramètres régionaux (LCID). C’est une valeur de un à quatre chiffres hexadécimaux sans préfixe 0x et sans zéros non significatifs. L’identificateur LCID peut avoir un identificateur indépendant de la sous-langue.
`flags`	facultatif. Représentation sous forme de chaîne des indicateurs pour cette bibliothèque de types. Plus précisément, cela doit être l’une de ces valeurs : « RESTRICTED », « CONTROL », « HIDDEN » et « HASDISKIMAGE ».

comClass

L’élément comClass est un enfant facultatif de l’élément file, mais il est obligatoire si l’application ClickOnce contient un composant COM qu’elle a l’intention de déployer à l’aide de COM sans inscription. L’élément a les attributs suivants.

Attribut	Description
`clsid`	Obligatoire. ID de classe du composant COM, exprimé sous forme de GUID.
`description`	facultatif. Nom de la classe.
`threadingModel`	facultatif. Modèle de thread utilisé par les classes COM in-process. Si cette propriété a la valeur Null, aucun modèle de thread n’est utilisé. Le composant est créé sur le thread principal du client et les appels provenant d’autres threads sont marshalés sur ce thread. La liste suivante présente les valeurs valides : `Apartment`, `Free`, `Both` et `Neutral`.
`tlbid`	facultatif. GUID de la bibliothèque de types pour ce composant COM.
`progid`	facultatif. Identificateur programmatique dépendant de la version qui est associé au composant COM. Un identificateur `ProgID` a le format `<vendor>.<component>.<version>`.
`miscStatus`	facultatif. Duplique dans le manifeste de l’assembly les informations fournies par la clé de Registre `MiscStatus`. Si les valeurs des attributs `miscStatusIcon`, `miscStatusContent`, `miscStatusDocprint` ou `miscStatusThumbnail` sont introuvables, la valeur par défaut correspondante listée dans `miscStatus` est utilisée pour les attributs manquants. La valeur peut être une liste, délimitée par des virgules, des valeurs d’attribut indiquées dans le tableau suivant. Vous pouvez utiliser cet attribut si la classe COM est une classe OCX qui nécessite des valeurs de la clé de Registre `MiscStatus`.
`miscStatusIcon`	facultatif. Duplique dans le manifeste de l’assembly les informations fournies par DVASPECT_ICON. Il peut fournir une icône d’un objet. La valeur peut être une liste, délimitée par des virgules, des valeurs d’attribut indiquées dans le tableau suivant. Vous pouvez utiliser cet attribut si la classe COM est une classe OCX qui nécessite des valeurs de la clé de Registre `Miscstatus`.
`miscStatusContent`	facultatif. Duplique dans le manifeste de l’assembly les informations fournies par DVASPECT_CONTENT. Il peut fournir un document composé affichable à l’écran ou imprimable sur une imprimante. La valeur peut être une liste, délimitée par des virgules, des valeurs d’attribut indiquées dans le tableau suivant. Vous pouvez utiliser cet attribut si la classe COM est une classe OCX qui nécessite des valeurs de la clé de Registre `MiscStatus`.
`miscStatusDocPrint`	facultatif. Duplique dans le manifeste de l’assembly les informations fournies par DVASPECT_DOCPRINT. Il peut fournir une représentation d’objet affichable à l’écran tel qu’il serait imprimé sur une imprimante. La valeur peut être une liste, délimitée par des virgules, des valeurs d’attribut indiquées dans le tableau suivant. Vous pouvez utiliser cet attribut si la classe COM est une classe OCX qui nécessite des valeurs de la clé de Registre `MiscStatus`.
`miscStatusThumbnail`	facultatif. Duplique dans le manifeste de l’assembly les informations fournies par DVASPECT_THUMBNAIL. Il peut fournir une miniature d’un objet affichable dans un outil de navigation. La valeur peut être une liste, délimitée par des virgules, des valeurs d’attribut indiquées dans le tableau suivant. Vous pouvez utiliser cet attribut si la classe COM est une classe OCX qui nécessite des valeurs de la clé de Registre `MiscStatus`.

comInterfaceExternalProxyStub

L’élément comInterfaceExternalProxyStub est un enfant facultatif de l’élément file, mais il peut être obligatoire si l’application ClickOnce contient un composant COM qu’elle a l’intention de déployer à l’aide de COM sans inscription. L'élément contient les attributs ci-dessous.

Attribut	Description
`iid`	Obligatoire. ID d’interface (IID) qui est pris en charge par ce proxy. L’IID doit être entouré d’accolades.
`baseInterface`	facultatif. IID de l’interface dont l’interface référencée par la propriété `iid` est dérivée.
`numMethods`	facultatif. Nombre de méthodes implémentées par l’interface.
`name`	facultatif. Nom de l’interface tel qu’il apparaîtra dans le code.
`tlbid`	facultatif. Bibliothèque de types qui contient la description de l’interface spécifiée par l’attribut `iid`.
`proxyStubClass32`	facultatif. Mappe un IID à un CLSID dans des DLL proxy 32 bits.

comInterfaceProxyStub

L’élément comInterfaceProxyStub est un enfant facultatif de l’élément file, mais il peut être obligatoire si l’application ClickOnce contient un composant COM qu’elle a l’intention de déployer à l’aide de COM sans inscription. L'élément contient les attributs ci-dessous.

Attribut	Description
`iid`	Obligatoire. ID d’interface (IID) qui est pris en charge par ce proxy. L’IID doit être entouré d’accolades.
`baseInterface`	facultatif. IID de l’interface dont l’interface référencée par la propriété `iid` est dérivée.
`numMethods`	facultatif. Nombre de méthodes implémentées par l’interface.
`Name`	facultatif. Nom de l’interface tel qu’il apparaîtra dans le code.
`Tlbid`	facultatif. Bibliothèque de types qui contient la description de l’interface spécifiée par l’attribut `iid`.
`proxyStubClass32`	facultatif. Mappe un IID à un CLSID dans des DLL proxy 32 bits.
`threadingModel`	facultatif. facultatif. Modèle de thread utilisé par les classes COM in-process. Si cette propriété a la valeur Null, aucun modèle de thread n’est utilisé. Le composant est créé sur le thread principal du client et les appels provenant d’autres threads sont marshalés sur ce thread. La liste suivante présente les valeurs valides : `Apartment`, `Free`, `Both` et `Neutral`.

windowClass

L’élément windowClass est un enfant facultatif de l’élément file, mais il peut être obligatoire si l’application ClickOnce contient un composant COM qu’elle a l’intention de déployer à l’aide de COM sans inscription. L’élément référence une classe de fenêtre définie par le composant COM auquel une version doit être appliquée. L'élément contient les attributs ci-dessous.

Attribut Description

versioned facultatif. Contrôle si le nom de la classe de fenêtre interne utilisé dans l’inscription contient la version de l’assembly qui contient la classe de fenêtre. Cet attribut peut avoir la valeur yes ou no. La valeur par défaut est yes. La valeur no doit être utilisée uniquement si la même classe de fenêtre est définie par un composant côte à côte et un composant non côte à côte équivalent et que vous souhaitez les traiter en tant que classe de fenêtre identique. Notez que les règles habituelles relatives à l’inscription de la classe de fenêtre s’appliquent : seul le premier composant qui inscrit la classe de fenêtre pourra l’inscrire, car aucune version ne lui est appliquée.

Attribut	Description
`versioned`	facultatif. Contrôle si le nom de la classe de fenêtre interne utilisé dans l’inscription contient la version de l’assembly qui contient la classe de fenêtre. Cet attribut peut avoir la valeur `yes` ou `no`. La valeur par défaut est `yes`. La valeur `no` doit être utilisée uniquement si la même classe de fenêtre est définie par un composant côte à côte et un composant non côte à côte équivalent et que vous souhaitez les traiter en tant que classe de fenêtre identique. Notez que les règles habituelles relatives à l’inscription de la classe de fenêtre s’appliquent : seul le premier composant qui inscrit la classe de fenêtre pourra l’inscrire, car aucune version ne lui est appliquée.

hash

L’élément hash est un enfant facultatif de l’élément file. L’élément hash ne comporte pas d’attributs.

ClickOnce utilise un hachage algorithmique de tous les fichiers dans une application en guise de vérification de sécurité, et s’assure ainsi qu’aucun des fichiers n’a été modifié après le déploiement. Si l’élément hash n’est pas inclus, cette vérification n’est pas effectuée. Il est donc déconseillé d’omettre l’élément hash.

Si un manifeste contient un fichier qui n’est pas haché, il ne peut pas être signé numériquement, car les utilisateurs ne peuvent pas vérifier le contenu d’un fichier non haché.

dsig:Transforms

L’élément dsig:Transforms est un enfant obligatoire de l’élément hash. L’élément dsig:Transforms ne comporte pas d’attributs.

dsig:Transform

L’élément dsig:Transform est un enfant obligatoire de l’élément dsig:Transforms. L’élément dsig:Transform a les attributs suivants.

Attribut	Description
`Algorithm`	Algorithme utilisé pour calculer le code de hachage pour ce fichier. Actuellement, la seule valeur utilisée par ClickOnce est `urn:schemas-microsoft-com:HashTransforms.Identity`.

dsig:DigestMethod

L’élément dsig:DigestMethod est un enfant obligatoire de l’élément hash. L’élément dsig:DigestMethod a les attributs suivants.

Attribut	Description
`Algorithm`	Algorithme utilisé pour calculer le code de hachage pour ce fichier. Actuellement, la seule valeur utilisée par ClickOnce est `http://www.w3.org/2000/09/xmldsig#sha1`.

dsig:DigestValue

L’élément dsig:DigestValue est un enfant obligatoire de l’élément hash. L’élément dsig:DigestValue ne comporte pas d’attributs. Sa valeur texte est le hachage calculé pour le fichier spécifié.

Notes

Cet élément identifie tous les fichiers hors assembly qui composent l’application et, en particulier, les valeurs de hachage pour la vérification des fichiers. Cet élément peut aussi inclure des données d’isolation COM (Component Object Model) associées au fichier. Si un fichier change, le fichier manifeste de l’application doit également être modifié pour refléter le changement.

Exemple

L’exemple de code suivant illustre les éléments file contenus dans le manifeste d’une application déployée à l’aide de ClickOnce.

<file name="Icon.ico" size="9216">
  <hash>
    <dsig:Transforms>
      <dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity" />
    </dsig:Transforms>
    <dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
    <dsig:DigestValue>lVoj+Rh6RQ/HPNLOdayQah5McrI=</dsig:DigestValue>
  </hash>
</file>

Voir aussi

Manifeste d’application ClickOnce

Partager via