Langue

<élément file> (application ClickOnce)

Identifie tous les fichiers nonassembly 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.

Caractéristique Description
name Required. Identifie le nom du fichier.
size Required. Spécifie la taille, en octets, du fichier.
group Facultatif, si l’attribut optional n’est pas spécifié ou défini sur false; obligatoire si c’est truele casoptional. Nom du groupe auquel appartient ce fichier. Le nom peut être n’importe quelle valeur de chaîne Unicode choisie par le développeur et est utilisé pour télécharger des fichiers à la demande avec la ApplicationDeployment classe.
optional Optional. 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 le demande à la demande. Si false elle est définie ou non définie, le fichier est téléchargé lors de la première exécution ou de 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 true si writeableType elle est spécifiée avec la valeur applicationData.
writeableType Optional. 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 de fichier. L’élément décrit la bibliothèque de types qui appartient au composant COM. L’élément a les attributs suivants.

Caractéristique Description
tlbid Required. GUID affecté à la bibliothèque de types.
version Required. Numéro de version de la bibliothèque de types.
helpdir Required. Répertoire qui contient les fichiers d’aide du composant. Peut être de longueur nulle.
resourceid Optional. Représentation sous forme de chaîne hexadécimale de l’identificateur de paramètres régionaux (LCID). Il s’agit d’un à quatre chiffres hexadécimaux sans préfixe 0x et sans zéros non significatifs. Le LCID peut avoir un identificateur de sous-langage neutre.
flags Optional. Représentation sous forme de chaîne des indicateurs de bibliothèque de types pour cette bibliothèque de types. Plus précisément, il doit s’agir de « RESTRICTED », « CONTROL », « HIDDEN » et « HASDISKIMAGE ».

comClass

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

Caractéristique Description
clsid Required. ID de classe du composant COM exprimé en tant que GUID.
description Optional. Nom de la classe.
threadingModel Optional. 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 d’autres threads sont marshalés vers ce thread. La liste suivante présente les valeurs valides :

Apartment, Free, Both et Neutral.
tlbid Optional. GUID de la bibliothèque de types pour ce composant COM.
progid Optional. Identificateur programmatique dépendant de la version associé au composant COM. Le format d’un ProgID est <vendor>.<component>.<version>.
miscStatus Optional. Dupliquer dans le manifeste d’assembly les informations fournies par la clé de MiscStatus Registre. Si les valeurs pour les miscStatusIconattributs , ou miscStatusThumbnailmiscStatusContentmiscStatusDocprintles attributs ne sont pas trouvés, la valeur par défaut correspondante répertorié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 du tableau suivant. Vous pouvez utiliser cet attribut si la classe COM est une classe OCX qui nécessite des MiscStatus valeurs de clé de Registre.
miscStatusIcon Optional. Dupliquer 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 délimitée par des virgules des valeurs d’attribut du tableau suivant. Vous pouvez utiliser cet attribut si la classe COM est une classe OCX qui nécessite des Miscstatus valeurs de clé de Registre.
miscStatusContent Optional. Doublons dans le manifeste d’assembly les informations fournies par DVASPECT_CONTENT. Il peut fournir un document composé pouvant être affiché pour un écran ou une imprimante. La valeur peut être une liste délimitée par des virgules des valeurs d’attribut du tableau suivant. Vous pouvez utiliser cet attribut si la classe COM est une classe OCX qui nécessite des MiscStatus valeurs de clé de Registre.
miscStatusDocPrint Optional. Dupliquer dans le manifeste d’assembly les informations fournies par DVASPECT_DOCPRINT. Il peut fournir une représentation d’objet affichable à l’écran comme s’il est imprimé sur une imprimante. La valeur peut être une liste délimitée par des virgules des valeurs d’attribut du tableau suivant. Vous pouvez utiliser cet attribut si la classe COM est une classe OCX qui nécessite des MiscStatus valeurs de clé de Registre.
miscStatusThumbnail Optional. Dupliquer dans un manifeste d’assembly les informations fournies par DVASPECT_THUMBNAIL. Il peut fournir une miniature d’un objet pouvant être affiché dans un outil de navigation. La valeur peut être une liste délimitée par des virgules des valeurs d’attribut du tableau suivant. Vous pouvez utiliser cet attribut si la classe COM est une classe OCX qui nécessite des MiscStatus valeurs de clé de Registre.

comInterfaceExternalProxyStub

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

Caractéristique Description
iid Required. ID d’interface (IID) qui est servi par ce proxy. L’IID doit avoir des accolades qui l’entourent.
baseInterface Optional. IID de l’interface à partir de laquelle l’interface référencée est iid dérivée.
numMethods Optional. Nombre de méthodes implémentées par l’interface.
name Optional. Nom de l’interface telle qu’elle apparaît dans le code.
tlbid Optional. Bibliothèque de types qui contient la description de l’interface spécifiée par l’attribut iid .
proxyStubClass32 Optional. 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 peut être requis si l’application ClickOnce contient un composant COM qu’elle envisage de déployer à l’aide de COM sans inscription. L’élément contient les attributs suivants.

Caractéristique Description
iid Required. ID d’interface (IID) qui est servi par ce proxy. L’IID doit avoir des accolades qui l’entourent.
baseInterface Optional. IID de l’interface à partir de laquelle l’interface référencée est iid dérivée.
numMethods Optional. Nombre de méthodes implémentées par l’interface.
Name Optional. Nom de l’interface telle qu’elle apparaît dans le code.
Tlbid Optional. Bibliothèque de types qui contient la description de l’interface spécifiée par l’attribut iid .
proxyStubClass32 Optional. Mappe un IID à un CLSID dans des DLL proxy 32 bits.
threadingModel Optional. Optional. 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 d’autres threads sont marshalés vers 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 peut être requis si l’application ClickOnce contient un composant COM qu’elle envisage de déployer à l’aide de 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 appliquée à celle-ci. L’élément contient les attributs suivants.

Caractéristique Description
versioned Optional. Détermine 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 ne doit être utilisée que 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 comme la même classe de fenêtre. Notez que les règles habituelles relatives à l’inscription de classe de fenêtre s’appliquent : seul le premier composant qui inscrit la classe de fenêtre pourra l’inscrire, car il n’a pas de version appliquée à celle-ci.

hachis

L’élément hash est un enfant facultatif de l’élément file . L’élément hash n’a aucun attribut.

ClickOnce utilise un hachage algorithmique de tous les fichiers d’une application en tant que vérification de sécurité pour vous assurer 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. Par conséquent, l’omission de l’élément hash n’est pas recommandée.

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

dsig :Transforms

L’élément dsig:Transforms est un enfant requis de l’élément hash . L’élément dsig:Transforms n’a aucun attribut.

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.

Caractéristique Description
Algorithm Algorithme utilisé pour calculer le digest 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 requis de l’élément hash . L’élément dsig:DigestMethod a les attributs suivants.

Caractéristique Description
Algorithm Algorithme utilisé pour calculer le digest 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 requis de l’élément hash . L’élément dsig:DigestValue n’a aucun attribut. Sa valeur de texte est le hachage calculé pour le fichier spécifié.

Remarques

Cet élément identifie tous les fichiers nonassembly qui composent l’application et, en particulier, les valeurs de hachage pour la vérification de fichier. Cet élément peut également 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 mis à jour pour refléter la modification.

Example

L’exemple de code suivant illustre les file éléments d’un manifeste d’application pour 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

  • Dernière mise à jour :