Taal

<bestandselement> (ClickOnce-toepassing)

Identificeert alle niet-assembly-bestanden die door de toepassing zijn gedownload en gebruikt.

Syntaxis

<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>

Elementen en kenmerken

Het file element is optioneel. Het element heeft de volgende kenmerken.

Attribute Description
name Required. Identificeert de naam van het bestand.
size Required. Hiermee geeft u de grootte, in bytes, van het bestand.
group Optioneel, als het optional kenmerk niet is opgegeven of is ingesteld op false; vereist indien optional .true De naam van de groep waartoe dit bestand behoort. De naam kan elke Unicode-tekenreekswaarde zijn die door de ontwikkelaar wordt gekozen en wordt gebruikt voor het downloaden van bestanden op aanvraag met de <xref:System.Deployment.Application.ApplicationDeployment> klasse.
optional Optional. Hiermee geeft u op of dit bestand moet worden gedownload wanneer de toepassing voor het eerst wordt uitgevoerd of of het bestand zich alleen op de server moet bevinden totdat de toepassing het op aanvraag aanvraagt. Als false of niet gedefinieerd, wordt het bestand gedownload wanneer de toepassing voor het eerst wordt uitgevoerd of geïnstalleerd. Als true, moet een group moet worden opgegeven om het toepassingsmanifest geldig te zijn. optional kan niet waar zijn als writeableType deze is opgegeven met de waarde applicationData.
writeableType Optional. Hiermee geeft u op dat dit bestand een gegevensbestand is. Momenteel is applicationDatade enige geldige waarde.

typelib

Het typelib element is een optioneel onderliggend element van het bestandselement. Het element beschrijft de typebibliotheek die deel uitmaakt van het COM-onderdeel. Het element heeft de volgende kenmerken.

Attribute Description
tlbid Required. De GUID die is toegewezen aan de typebibliotheek.
version Required. Het versienummer van de typebibliotheek.
helpdir Required. De map met de Help-bestanden voor het onderdeel. Kan de lengte nul hebben.
resourceid Optional. De hexadecimale tekenreeksweergave van de landinstellings-id (LCID). Het is één tot vier hexadecimale cijfers zonder voorvoegsel van 0x en zonder voorloopnullen. De LCID kan een neutrale subtaal-id hebben.
flags Optional. De tekenreeksweergave van de typebibliotheekvlagmen voor dit typebibliotheek. Het moet met name een van 'RESTRICTED', 'CONTROL', 'HIDDEN' en 'HASDISKIMAGE' zijn.

comClass

Het comClass element is een optioneel onderliggend element, maar is vereist als de ClickOnce-toepassing een COM-onderdeel bevat dat wordt geïmplementeerd met behulp van file COM zonder registratie. Het element heeft de volgende kenmerken.

Attribute Description
clsid Required. De klasse-id van het COM-onderdeel, uitgedrukt als een GUID.
description Optional. De naam van de klasse.
threadingModel Optional. Het threadingmodel dat wordt gebruikt door COM-klassen in het proces. Als deze eigenschap null is, wordt er geen threadingmodel gebruikt. Het onderdeel wordt gemaakt op de hoofdthread van de client en aanroepen van andere threads worden marshaled naar deze thread. De volgende lijst bevat de geldige waarden:

Apartment, Free, Both en Neutral.
tlbid Optional. GUID voor de typebibliotheek voor dit COM-onderdeel.
progid Optional. Versieafhankelijke programmatische id die is gekoppeld aan het COM-onderdeel. De indeling van een ProgID is <vendor>.<component>.<version>.
miscStatus Optional. Duplicaten in het assemblymanifest de informatie die door de MiscStatus registersleutel wordt verstrekt. Als waarden voor de miscStatusIcon, miscStatusContentof miscStatusDocprintmiscStatusThumbnail kenmerken niet worden gevonden, wordt de bijbehorende standaardwaarde gebruikt miscStatus voor de ontbrekende kenmerken. De waarde kan een door komma's gescheiden lijst zijn van de kenmerkwaarden uit de volgende tabel. U kunt dit kenmerk gebruiken als de COM-klasse een OCX-klasse is waarvoor registersleutelwaarden zijn vereist MiscStatus .
miscStatusIcon Optional. Duplicaten in het assemblymanifest de informatie van DVASPECT_ICON. Het kan een pictogram van een object bevatten. De waarde kan een door komma's gescheiden lijst zijn van de kenmerkwaarden uit de volgende tabel. U kunt dit kenmerk gebruiken als de COM-klasse een OCX-klasse is waarvoor registersleutelwaarden zijn vereist Miscstatus .
miscStatusContent Optional. Duplicaten in het assemblymanifest de informatie van DVASPECT_CONTENT. Het kan een samengesteld document bieden dat kan worden weergegeven voor een scherm of printer. De waarde kan een door komma's gescheiden lijst zijn van de kenmerkwaarden uit de volgende tabel. U kunt dit kenmerk gebruiken als de COM-klasse een OCX-klasse is waarvoor registersleutelwaarden zijn vereist MiscStatus .
miscStatusDocPrint Optional. Duplicaten in het assemblymanifest de informatie van DVASPECT_DOCPRINT. Het kan een objectweergave bieden die op het scherm kan worden weergegeven alsof het wordt afgedrukt naar een printer. De waarde kan een door komma's gescheiden lijst zijn van de kenmerkwaarden uit de volgende tabel. U kunt dit kenmerk gebruiken als de COM-klasse een OCX-klasse is waarvoor registersleutelwaarden zijn vereist MiscStatus .
miscStatusThumbnail Optional. Duplicaten in een assemblymanifest de informatie die door DVASPECT_THUMBNAIL wordt verstrekt. Het kan een miniatuur van een object bieden dat kan worden weergegeven in een browserprogramma. De waarde kan een door komma's gescheiden lijst zijn van de kenmerkwaarden uit de volgende tabel. U kunt dit kenmerk gebruiken als de COM-klasse een OCX-klasse is waarvoor registersleutelwaarden zijn vereist MiscStatus .

comInterfaceExternalProxyStub

Het comInterfaceExternalProxyStub element is een optioneel onderliggend element, maar is mogelijk vereist als de ClickOnce-toepassing een COM-onderdeel bevat dat wordt geïmplementeerd met behulp van file com-registratievrij COM. Het element bevat de volgende kenmerken.

Attribute Description
iid Required. De interface-id (IID) die wordt geleverd door deze proxy. De IID moet accolades eromheen hebben.
baseInterface Optional. De IID van de interface waarnaar wordt verwezen door iid de interface is afgeleid.
numMethods Optional. Het aantal methoden dat door de interface is geïmplementeerd.
name Optional. De naam van de interface zoals deze in code wordt weergegeven.
tlbid Optional. De typebibliotheek die de beschrijving bevat van de interface die is opgegeven door het iid kenmerk.
proxyStubClass32 Optional. Wijst een IID toe aan een CLSID in 32-bits proxy-DLL's.

comInterfaceProxyStub

Het comInterfaceProxyStub element is een optioneel onderliggend element, maar is mogelijk vereist als de ClickOnce-toepassing een COM-onderdeel bevat dat wordt geïmplementeerd met behulp van file com-registratievrij COM. Het element bevat de volgende kenmerken.

Attribute Description
iid Required. De interface-id (IID) die wordt geleverd door deze proxy. De IID moet accolades eromheen hebben.
baseInterface Optional. De IID van de interface waarnaar wordt verwezen door iid de interface is afgeleid.
numMethods Optional. Het aantal methoden dat door de interface is geïmplementeerd.
Name Optional. De naam van de interface zoals deze in code wordt weergegeven.
Tlbid Optional. De typebibliotheek die de beschrijving bevat van de interface die is opgegeven door het iid kenmerk.
proxyStubClass32 Optional. Wijst een IID toe aan een CLSID in 32-bits proxy-DLL's.
threadingModel Optional. Optional. Het threadingmodel dat wordt gebruikt door COM-klassen in het proces. Als deze eigenschap null is, wordt er geen threadingmodel gebruikt. Het onderdeel wordt gemaakt op de hoofdthread van de client en aanroepen van andere threads worden marshaled naar deze thread. De volgende lijst bevat de geldige waarden:

Apartment, Free, Both en Neutral.

windowClass

Het windowClass element is een optioneel onderliggend element, maar is mogelijk vereist als de ClickOnce-toepassing een COM-onderdeel bevat dat wordt geïmplementeerd met behulp van file com-registratievrij COM. Het element verwijst naar een vensterklasse die is gedefinieerd door het COM-onderdeel waarop een versie moet worden toegepast. Het element bevat de volgende kenmerken.

Attribute Description
versioned Optional. Hiermee bepaalt u of de naam van de interne vensterklasse die in de registratie wordt gebruikt, de versie van de assembly bevat die de vensterklasse bevat. De waarde van dit kenmerk kan of yesno. De standaardwaarde is yes. De waarde no mag alleen worden gebruikt als dezelfde vensterklasse is gedefinieerd door een side-by-side-component en een equivalent niet-naast-side-component en u deze wilt behandelen als dezelfde vensterklasse. Houd er rekening mee dat de gebruikelijke regels voor vensterklasseregistratie van toepassing zijn: alleen het eerste onderdeel dat de vensterklasse registreert, kan deze registreren, omdat er geen versie op is toegepast.

hekje

Het hash element is een optioneel onderliggend element.file Het hash element heeft geen kenmerken.

ClickOnce maakt gebruik van een algoritme-hash van alle bestanden in een toepassing als een beveiligingscontrole om ervoor te zorgen dat geen van de bestanden is gewijzigd na de implementatie. Als het hash element niet is opgenomen, wordt deze controle niet uitgevoerd. Daarom wordt het weglaten van het hash element niet aanbevolen.

Als een manifest een bestand bevat dat niet is gehasht, kan dat manifest niet digitaal worden ondertekend, omdat gebruikers de inhoud van een niet-gehasheerd bestand niet kunnen verifiëren.

dsig:Transformaties

Het dsig:Transforms element is een vereist onderliggend element van het hash element. Het dsig:Transforms element heeft geen kenmerken.

dsig:Transformeren

Het dsig:Transform element is een vereist onderliggend element van het dsig:Transforms element. Het dsig:Transform element heeft de volgende kenmerken.

Attribute Description
Algorithm Het algoritme dat wordt gebruikt om de samenvatting voor dit bestand te berekenen. Momenteel is urn:schemas-microsoft-com:HashTransforms.Identityde enige waarde die door ClickOnce wordt gebruikt.

dsig:DigestMethod

Het dsig:DigestMethod element is een vereist onderliggend element van het hash element. Het dsig:DigestMethod element heeft de volgende kenmerken.

Attribute Description
Algorithm Het algoritme dat wordt gebruikt om de samenvatting voor dit bestand te berekenen. Momenteel is http://www.w3.org/2000/09/xmldsig#sha1de enige waarde die door ClickOnce wordt gebruikt.

dsig:DigestValue

Het dsig:DigestValue element is een vereist onderliggend element van het hash element. Het dsig:DigestValue element heeft geen kenmerken. De tekstwaarde is de berekende hash voor het opgegeven bestand.

Remarks

Dit element identificeert alle niet-assembly-bestanden waaruit de toepassing bestaat, en met name de hashwaarden voor bestandsverificatie. Dit element kan ook COM-isolatiegegevens (Component Object Model) bevatten die aan het bestand zijn gekoppeld. Als een bestand wordt gewijzigd, moet het manifestbestand van de toepassing ook worden bijgewerkt om de wijziging weer te geven.

Example

In het volgende codevoorbeeld ziet u elementen in een toepassingsmanifest file voor een toepassing die is geïmplementeerd met 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>

Zie ook