<fileAssociation> , élément (application ClickOnce)<fileAssociation> element (ClickOnce application)

Identifie une extension de fichier à associer à l’application.Identifies a file extension to be associated with the application.

SyntaxeSyntax

<fileAssociation
    xmlns="urn:schemas-microsoft-com:clickonce.v1"
    extension
    description
    progid
    defaultIcon
/>

Éléments et attributsElements and attributes

L’élément fileAssociation est facultatif.The fileAssociation element is optional. L’élément a les attributs suivants.The element has the following attributes.

AttributAttribute DescriptionDescription
extension Obligatoire.Required. L’extension de fichier à associer à l’application.The file extension to be associated with the application.
description Obligatoire.Required. Description du type de fichier pour une utilisation par l’interpréteur de commandes.A description of the file type for use by the shell.
progid Obligatoire.Required. Un nom identifiant de manière unique le type de fichier.A name uniquely identifying the file type.
defaultIcon Obligatoire.Required. Spécifie l’icône à utiliser pour les fichiers avec cette extension.Specifies the icon to use for files with this extension. Le fichier icône doit être spécifié à l’aide de la <fichier > élément au sein de la <assembly > élément qui contient cet élément.The icon file must be specified by using the <file> Element within the <assembly> Element that contains this element.

NotesRemarks

Cet élément doit inclure une référence d’espace de noms XML à « urn : schemas-microsoft-ClickOnce.v 1 ».This element must include an XML namespace reference to "urn:schemas-microsoft-com:clickonce.v1". Si le <fileAssociation> élément est utilisé, il doit être placée après le <application> élément dans son parent <assembly > élément.If the <fileAssociation> element is used, it must come after the <application> element in its parent <assembly> Element.

ClickOnceClickOnce ne remplace pas les associations de fichiers existantes.will not overwrite existing file associations. Toutefois, une application ClickOnce peut remplacer l’extension de fichier pour l’utilisateur actuel uniquement.However, a ClickOnce application can override the file extension for the current user only. Une fois que cette application ClickOnce est désinstallée, ClickOnce supprime l’association de fichier pour l’utilisateur, et l’association de la machine est à nouveau active.After that ClickOnce application is uninstalled, ClickOnce deletes the file association for the user, and the per-machine association is active again.

ExempleExample

L’exemple de code suivant illustre fileAssociation manifeste des éléments dans une application pour un éditeur de texte déployé à l’aide ClickOnceClickOnce.The following code example illustrates fileAssociation elements in an application manifest for a text editor application deployed using ClickOnceClickOnce. Cet exemple de code inclut également le <fichier > élément requis par le defaultIcon attribut.This code example also includes the <file> Element required by the defaultIcon attribute.

<file name="text.ico" size="4286">
  <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>0joAqhmfeBb93ZneZv/oTMP2brY=</dsig:DigestValue>
  </hash>
</file>
<file name="writing.ico" size="9662">
  <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>2cL2U7cm13nG40v9MQdxYKazIwI=</dsig:DigestValue>
  </hash>
</file>
<fileAssociation xmlns="urn:schemas-microsoft-com:clickonce.v1" extension=".text" description="Text  Document (ClickOnce)" progid="Text.Document" defaultIcon="text.ico" />
<fileAssociation xmlns="urn:schemas-microsoft-com:clickonce.v1" extension=".writing" description="Writings (ClickOnce)" progid="Writing.Document" defaultIcon="writing.ico" />

Voir aussiSee also