<file>, élément (Application ClickOnce)

Article
08/10/2011

Identifie tous les fichiers autres que les fichiers d'assembly téléchargés et utilisés par l'application.

<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'attribut file est facultatif. L'élément possède les attributs suivants.

Attribut	Description
name	Obligatoire. Identifie le nom du fichier.
size	Obligatoire. Spécifie la taille du fichier en octets.
group	Facultatif si l'attribut optional n'est pas spécifié ou est défini sur false ; obligatoire si optional a la valeur true. Nom du groupe auquel ce fichier appartient. Il peut s'agir d'une valeur de chaîne Unicode quelconque choisie par le développeur. Ce nom est utilisé pour télécharger des fichiers à la demande avec la classe ApplicationDeployment.
optional	Facultatif. Spécifie si ce fichier doit se télécharger lorsque l'application est exécutée en premier, ou si le fichier doit résider uniquement sur le serveur jusqu'à ce que l'application le demande à la demande. Si la valeur est false ou non définie, le fichier est téléchargé au premier démarrage ou à l'installation de l'application. Si true, un group doit être spécifié pour que le manifeste de l'application soit valide. optional ne peut pas être vrai si writeableType est spécifié avec la valeur applicationData.
writeableType	Facultatif. Spécifie que ce fichier est un fichier de données. À l'heure actuelle, la seule valeur valide est applicationData.

typelib

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

Attribut	Description
tlbid	Obligatoire. GUID assigné à 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 pour le composant. Peut être de longueur zéro.
resourceid	Facultatif. Représentation sous forme de chaîne hexadécimale de l'identificateur de paramètres régionaux (LCID). Elle se compose de un à quatre chiffres hexadécimaux sans le préfixe 0x et sans zéro au début. Le LCID peut avoir un identificateur de sous-langue neutre.
flags	Facultatif. Représentation sous forme d'indicateurs de chaîne de la bibliothèque de types pour cette bibliothèque de types. En particulier, elle doit être "RESTRICTED", "CONTROL", "HIDDEN" ou "HASDISKIMAGE."

comClass

L'élément comClass est un enfant facultatif de l'élément file, mais est requis si l'application ClickOnce contient un composant COM qu'elle envisage de déployer à l'aide de COM sans inscription. L'élément possède les attributs suivants.

Attribut	Description
clsid	Obligatoire. Identificateur de classe du composant COM exprimé comme un GUID.
description	Facultatif. Nom de la classe.
threadingModel	Facultatif. Modèle de thread utilisé par les classes COM in-process. Si cette propriété est nulle, aucun modèle de thread n'est utilisé. Le composant est créé sur le thread principal du client et les appels depuis d'autres threads sont marshalés à ce thread. La liste suivante affiche les valeurs valides : Apartment, Free, Both et Neutral.
tlbid	Facultatif. GUID de la bibliothèque de types de ce composant COM.
progid	Facultatif. Identificateur programmatique dépendant de la version associé au composant COM. Le format d'un ProgID est <vendor>.<component>.<version>.
miscStatus	Facultatif. Duplique dans le manifeste d'assembly les informations fournies par la clé de Registre MiscStatus. Si les valeurs des attributs miscStatusIcon, miscStatusContent, miscStatusDocprint ou miscStatusThumbnail ne sont pas trouvées, la valeur par défaut correspondante répertoriée dans miscStatus est utilisée pour les attributs manquants. La valeur peut être une liste des valeurs d'attribut délimitée par des virgules pour le tableau suivant. Vous pouvez utiliser cet attribut si la classe COM est une classe OCX qui requiert des valeurs de clés de Registre MiscStatus.
miscStatusIcon	Facultatif. Duplique dans le manifeste d'assembly les informations fournies par DVASPECT_ICON. Il peut fournir une icône d'un objet. La valeur peut être une liste des valeurs d'attribut délimitée par des virgules pour le tableau suivant. Vous pouvez utiliser cet attribut si la classe COM est une classe OCX qui requiert des valeurs de clés de Registre Miscstatus.
miscStatusContent	Facultatif. Duplique dans le manifeste d'assembly les informations fournies par DVASPECT_CONTENT. Il peut fournir un document composé affichable sur un écran ou une imprimante. La valeur peut être une liste des valeurs d'attribut délimitée par des virgules pour le tableau suivant. Vous pouvez utiliser cet attribut si la classe COM est une classe OCX qui requiert des valeurs de clés de Registre MiscStatus.
miscStatusDocPrint	Facultatif. Duplique dans le manifeste d'assembly les informations fournies par DVASPECT_DOCPRINT. Il peut fournir une représentation d'objet affichable sur l'écran comme s'il était imprimé par une imprimante. La valeur peut être une liste des valeurs d'attribut délimitée par des virgules pour le tableau suivant. Vous pouvez utiliser cet attribut si la classe COM est une classe OCX qui requiert des valeurs de clés de Registre MiscStatus.
miscStatusThumbnail	Facultatif. Duplique dans un manifeste d'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 des valeurs d'attribut délimitée par des virgules pour le tableau suivant. Vous pouvez utiliser cet attribut si la classe COM est une classe OCX qui requiert des valeurs de clés de Registre MiscStatus.

comInterfaceExternalProxyStub

L'élément comInterfaceExternalProxyStub est un enfant facultatif de l'élément file, mais il peut être requis si l'application ClickOnce contient un composant COM qu'elle envisage de déployer avec COM sans inscription. L'élément contient les attributs suivants.

Attribut	Description
iid	Obligatoire. ID d'interface (IID) fourni par ce proxy. L'IID doit être entre accolades.
baseInterface	Facultatif. L'IID de l'interface à partir de laquelle l'interface référencée par 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ît 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 les DLL de proxy de 32 bits.

comInterfaceProxyStub

L'élément comInterfaceProxyStub est un enfant facultatif de l'élément file, mais il peut être requis si l'application ClickOnce contient un composant COM qu'elle envisage de déployer avec COM sans inscription. L'élément contient les attributs suivants.

Attribut	Description
iid	Obligatoire. ID d'interface (IID) fourni par ce proxy. L'IID doit être entre accolades.
baseInterface	Facultatif. L'IID de l'interface à partir de laquelle l'interface référencée par 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ît 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 les DLL de proxy de 32 bits.
threadingModel	Facultatif. Facultatif. Modèle de thread utilisé par les classes COM in-process. Si cette propriété est nulle, aucun modèle de thread n'est utilisé. Le composant est créé sur le thread principal du client et les appels depuis d'autres threads sont marshalés à ce thread. La liste suivante affiche 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 requis si l'application ClickOnce contient un composant COM qu'elle envisage de déployer avec COM sans inscription. L'élément fait référence à une classe de fenêtre définie par le composant COM qui doit avoir une version qui lui est appliquée. L'élément contient les attributs suivants.

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. La valeur de cet attribut peut être 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 par un équivalent du composant non côte à côte, et si vous souhaitez les traiter comme la même classe de fenêtre. Notez que les règles habituelles concernant l'inscription de classe de fenêtre s'appliquent — seul le premier composant qui enregistre la classe de fenêtre sera capable de l'enregistrer parce qu'aucune version ne lui est appliquée.

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. La valeur de cet attribut peut être 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 par un équivalent du composant non côte à côte, et si vous souhaitez les traiter comme la même classe de fenêtre. Notez que les règles habituelles concernant l'inscription de classe de fenêtre s'appliquent — seul le premier composant qui enregistre la classe de fenêtre sera capable de l'enregistrer parce qu'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 contient pas d'attributs.

ClickOnce utilise un hachage algorithmique de tous les fichiers dans une application comme vérification de la sécurité, pour garantir 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 ne sera pas effectuée. Par conséquent, il n'est pas recommandé d'omettre l'élément hash.

Un manifeste qui contient un fichier qui n'est pas haché 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 requis de l'élément hash. L'élément dsig:Transforms ne contient pas d'attributs.

dsig:Transform

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

Attribut	Description
Algorithm	Algorithme utilisé pour calculer le Digest de ce fichier. À l'heure actuelle, la seule valeur utilisée par ClickOnce est urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

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

Attribut	Description
Algorithm	Algorithme utilisé pour calculer le Digest de ce fichier. À l'heure actuelle, la seule valeur utilisée par ClickOnce est http://www.w3.org/2000/09/xmldsig#sha1 #sha1.

dsig:DigestValue

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

Notes

Cet élément identifie tous les fichiers autres que les fichiers d'assembly qui composent l'application et notamment les valeurs de hachage utilisées pour la vérification des fichiers. Cet élément peut inclure également des données d'isolation COM associées au fichier. Si un fichier est modifié, le fichier manifeste d'application doit également être mis à jour pour refléter la modification.

Exemple

L'exemple de code suivant illustre les éléments file dans le manifeste d'une application déployée avec 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

Référence

Manifeste d'application ClickOnce

Partager via