<filelement> (ClickOnce-program)

Identifierar alla icke-insamlade filer som laddas ned och används av programmet.

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>

Element och attribut

Elementet file är valfritt. Elementet har följande attribut.

Attribute	Description
`name`	Required. Identifierar namnet på filen.
`size`	Required. Anger filens storlek i byte.
`group`	Valfritt om `optional` attributet inte har angetts eller angetts till `false`, krävs om `optional` är `true`. Namnet på den grupp som filen tillhör. Namnet kan vara valfritt Unicode-strängvärde som valts av utvecklaren och används för att ladda ned filer på begäran med ApplicationDeployment klassen.
`optional`	Optional. Anger om den här filen måste laddas ned när programmet först körs eller om filen endast ska finnas på servern tills programmet begär det på begäran. Om `false` eller är odefinierat laddas filen ned när programmet först körs eller installeras. Om `true`måste ett `group` anges för att programmanifestet ska vara giltigt. `optional` kan inte vara sant om `writeableType` anges med värdet `applicationData`.
`writeableType`	Optional. Anger att den här filen är en datafil. För närvarande är `applicationData`det enda giltiga värdet .

typelib

Elementet typelib är ett valfritt underordnat filelement. Elementet beskriver typbiblioteket som tillhör COM-komponenten. Elementet har följande attribut.

Attribute	Description
`tlbid`	Required. GUID som tilldelats typbiblioteket.
`version`	Required. Versionsnumret för typbiblioteket.
`helpdir`	Required. Katalogen som innehåller hjälpfilerna för komponenten. Kan vara noll längd.
`resourceid`	Optional. Den hexadecimala strängrepresentationen av språkidentifieraren (LCID). Det är en till fyra hexadecimala siffror utan ett 0x-prefix och utan inledande nollor. LCID kan ha en neutral underspråksidentifierare.
`flags`	Optional. Strängrepresentationen av typbiblioteksflaggor för det här typbiblioteket. Mer specifikt bör det vara en av "RESTRICTED", "CONTROL", "HIDDEN" och "HASDISKIMAGE".

comClass

Elementet comClass är ett valfritt underordnat file element, men krävs om ClickOnce-programmet innehåller en COM-komponent som det avser att distribuera med hjälp av registreringsfri COM. Elementet har följande attribut.

Attribute	Description
`clsid`	Required. Klass-ID för COM-komponenten uttryckt som ett GUID.
`description`	Optional. Klassnamnet.
`threadingModel`	Optional. Den trådningsmodell som används av com-klasser i processen. Om den här egenskapen är null används ingen trådmodell. Komponenten skapas i klientens huvudtråd och anrop från andra trådar konverteras till den här tråden. I följande lista visas giltiga värden: `Apartment`, `Free`, `Both` och `Neutral`.
`tlbid`	Optional. GUID för typbiblioteket för den här COM-komponenten.
`progid`	Optional. Versionsberoende programmatisk identifierare som är associerad med COM-komponenten. Formatet för en `ProgID` är `<vendor>.<component>.<version>`.
`miscStatus`	Optional. Dubbletter i sammansättningen visar den information som tillhandahålls av registernyckeln `MiscStatus` . Om värden för attributen `miscStatusIcon`, `miscStatusContent`, `miscStatusDocprint`eller `miscStatusThumbnail` inte hittas används motsvarande standardvärde som anges i `miscStatus` för de attribut som saknas. Värdet kan vara en kommaavgränsad lista över attributvärdena från följande tabell. Du kan använda det här attributet om COM-klassen är en OCX-klass som kräver `MiscStatus` registernyckelvärden.
`miscStatusIcon`	Optional. Dubbletter i sammansättningen visar den information som tillhandahålls av DVASPECT_ICON. Det kan ge en ikon för ett objekt. Värdet kan vara en kommaavgränsad lista över attributvärdena från följande tabell. Du kan använda det här attributet om COM-klassen är en OCX-klass som kräver `Miscstatus` registernyckelvärden.
`miscStatusContent`	Optional. Dubbletter i sammansättningen visar den information som tillhandahålls av DVASPECT_CONTENT. Det kan ge ett sammansatt dokument som kan visas för en skärm eller skrivare. Värdet kan vara en kommaavgränsad lista över attributvärdena från följande tabell. Du kan använda det här attributet om COM-klassen är en OCX-klass som kräver `MiscStatus` registernyckelvärden.
`miscStatusDocPrint`	Optional. Dubbletter i sammansättningen visar informationen som tillhandahålls av DVASPECT_DOCPRINT. Det kan ge en objektrepresentation som kan visas på skärmen som om den skrivs ut till en skrivare. Värdet kan vara en kommaavgränsad lista över attributvärdena från följande tabell. Du kan använda det här attributet om COM-klassen är en OCX-klass som kräver `MiscStatus` registernyckelvärden.
`miscStatusThumbnail`	Optional. Dubbletter i en sammansättning visar informationen som tillhandahålls av DVASPECT_THUMBNAIL. Den kan ge en miniatyrbild av ett objekt som kan visas i ett webbverktyg. Värdet kan vara en kommaavgränsad lista över attributvärdena från följande tabell. Du kan använda det här attributet om COM-klassen är en OCX-klass som kräver `MiscStatus` registernyckelvärden.

comInterfaceExternalProxyStub

Elementet comInterfaceExternalProxyStub är ett valfritt underordnat file element, men kan krävas om ClickOnce-programmet innehåller en COM-komponent som det avser att distribuera med hjälp av registreringsfri COM. Elementet innehåller följande attribut.

Attribute	Description
`iid`	Required. Gränssnitts-ID (IID) som hanteras av den här proxyn. IID måste ha klammerparenteser som omger det.
`baseInterface`	Optional. IID:t för gränssnittet som gränssnittet som refereras till härleds `iid` från.
`numMethods`	Optional. Antalet metoder som implementeras av gränssnittet.
`name`	Optional. Namnet på gränssnittet som det ska visas i kod.
`tlbid`	Optional. Typbiblioteket som innehåller beskrivningen av gränssnittet som anges av attributet `iid` .
`proxyStubClass32`	Optional. Mappar ett IID till ett CLSID i 32-bitars proxy-DLL:er.

comInterfaceProxyStub

Elementet comInterfaceProxyStub är ett valfritt underordnat file element, men kan krävas om ClickOnce-programmet innehåller en COM-komponent som det avser att distribuera med hjälp av registreringsfri COM. Elementet innehåller följande attribut.

Attribute	Description
`iid`	Required. Gränssnitts-ID (IID) som hanteras av den här proxyn. IID måste ha klammerparenteser som omger det.
`baseInterface`	Optional. IID:t för gränssnittet som gränssnittet som refereras till härleds `iid` från.
`numMethods`	Optional. Antalet metoder som implementeras av gränssnittet.
`Name`	Optional. Namnet på gränssnittet som det ska visas i kod.
`Tlbid`	Optional. Typbiblioteket som innehåller beskrivningen av gränssnittet som anges av attributet `iid` .
`proxyStubClass32`	Optional. Mappar ett IID till ett CLSID i 32-bitars proxy-DLL:er.
`threadingModel`	Optional. Optional. Den trådningsmodell som används av com-klasser i processen. Om den här egenskapen är null används ingen trådmodell. Komponenten skapas i klientens huvudtråd och anrop från andra trådar konverteras till den här tråden. I följande lista visas giltiga värden: `Apartment`, `Free`, `Both` och `Neutral`.

windowClass

Elementet windowClass är ett valfritt underordnat file element, men kan krävas om ClickOnce-programmet innehåller en COM-komponent som det avser att distribuera med hjälp av registreringsfri COM. Elementet refererar till en fönsterklass som definierats av COM-komponenten och som måste ha en version tillämpad på den. Elementet innehåller följande attribut.

Attribute Description

versioned Optional. Styr om det interna fönsterklassnamnet som används i registreringen innehåller den version av sammansättningen som innehåller fönsterklassen. Värdet för det här attributet kan vara yes eller no. Standardvärdet är yes. Värdet no ska endast användas om samma fönsterklass definieras av en komponent sida vid sida och en motsvarande komponent som inte är sida vid sida och du vill behandla dem som samma fönsterklass. Observera att de vanliga reglerna för registrering av fönsterklass gäller – endast den första komponenten som registrerar fönsterklassen kan registrera den, eftersom den inte har någon version tillämpad på den.

Attribute	Description
`versioned`	Optional. Styr om det interna fönsterklassnamnet som används i registreringen innehåller den version av sammansättningen som innehåller fönsterklassen. Värdet för det här attributet kan vara `yes` eller `no`. Standardvärdet är `yes`. Värdet `no` ska endast användas om samma fönsterklass definieras av en komponent sida vid sida och en motsvarande komponent som inte är sida vid sida och du vill behandla dem som samma fönsterklass. Observera att de vanliga reglerna för registrering av fönsterklass gäller – endast den första komponenten som registrerar fönsterklassen kan registrera den, eftersom den inte har någon version tillämpad på den.

hash-

Elementet hash är ett valfritt underordnat element file . Elementet hash har inga attribut.

ClickOnce använder en algoritmisk hash för alla filer i ett program som en säkerhetskontroll för att säkerställa att ingen av filerna har ändrats efter distributionen. Om elementet hash inte ingår utförs inte den här kontrollen. Därför rekommenderas inte att elementet hash utelämnas.

Om ett manifest innehåller en fil som inte är hashad kan manifestet inte signeras digitalt eftersom användarna inte kan verifiera innehållet i en fil som inte har sparats.

dsig:Transforms

Elementet dsig:Transforms är ett obligatoriskt underordnat element hash . Elementet dsig:Transforms har inga attribut.

dsig:Transform

Elementet dsig:Transform är ett obligatoriskt underordnat element dsig:Transforms . Elementet dsig:Transform har följande attribut.

Attribute	Description
`Algorithm`	Algoritmen som används för att beräkna sammandraget för den här filen. För närvarande är `urn:schemas-microsoft-com:HashTransforms.Identity`det enda värdet som används av ClickOnce .

dsig:DigestMethod

Elementet dsig:DigestMethod är ett obligatoriskt underordnat element hash . Elementet dsig:DigestMethod har följande attribut.

Attribute	Description
`Algorithm`	Algoritmen som används för att beräkna sammandraget för den här filen. För närvarande är `http://www.w3.org/2000/09/xmldsig#sha1`det enda värdet som används av ClickOnce .

dsig:DigestValue

Elementet dsig:DigestValue är ett obligatoriskt underordnat element hash . Elementet dsig:DigestValue har inga attribut. Dess textvärde är den beräknade hashen för den angivna filen.

Remarks

Det här elementet identifierar alla icke-sammansättningsfiler som utgör programmet och särskilt hash-värdena för filverifiering. Det här elementet kan också innehålla COM-isoleringsdata (Component Object Model) som är associerade med filen. Om en fil ändras måste även programmanifestfilen uppdateras för att återspegla ändringen.

Example

I följande kodexempel visas file element i ett programmanifest för ett program som distribueras med 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>

Se även

ClickOnce-programmanifest

Feedback

Var den här sidan till hjälp?

Uppdaterades senast 2026-08-28