<File-Element> (ClickOnce-Anwendung)

Identifiziert alle Nichtassembly-Dateien, die von der Anwendung heruntergeladen und verwendet werden.

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>

Elemente und Attribute

Das file-Element ist optional. Das Element weist die folgenden Attribute auf.

Attribute	Description
`name`	Required. Gibt den Namen der Datei an.
`size`	Required. Gibt die Größe der Datei in Bytes an.
`group`	Optional, wenn das `optional` Attribut nicht angegeben oder auf `false`; erforderlich ist, falls `optional` vorhanden.`true` Der Name der Gruppe, zu der diese Datei gehört. Der Name kann ein beliebiger Unicode-Zeichenfolgenwert sein, der vom Entwickler ausgewählt wird und zum Herunterladen von Dateien bei Bedarf mit der ApplicationDeployment Klasse verwendet wird.
`optional`	Dies ist optional. Gibt an, ob diese Datei beim ersten Ausführen der Anwendung heruntergeladen werden muss oder ob sich die Datei nur auf dem Server befinden soll, bis die Anwendung sie bei Bedarf anfordert. Wenn `false` oder nicht definiert, wird die Datei heruntergeladen, wenn die Anwendung zum ersten Mal ausgeführt oder installiert wird. Wenn `true`, muss ein `group` Wert angegeben werden, damit das Anwendungsmanifest gültig ist. `optional` kann nicht true sein, wenn `writeableType` mit dem Wert `applicationData`angegeben wird.
`writeableType`	Dies ist optional. Gibt an, dass es sich bei dieser Datei um eine Datendatei handelt. Derzeit ist `applicationData`der einzige gültige Wert .

typelib

Das typelib Element ist ein optionales untergeordnetes Element des Dateielements. Das Element beschreibt die Typbibliothek, die zur COM-Komponente gehört. Das Element weist die folgenden Attribute auf.

Attribute	Description
`tlbid`	Required. Die GUID, die der Typbibliothek zugewiesen ist.
`version`	Required. Die Versionsnummer der Typbibliothek.
`helpdir`	Required. Das Verzeichnis, das die Hilfedateien für die Komponente enthält. Kann nulllänge sein.
`resourceid`	Dies ist optional. Die hexadezimale Zeichenfolgendarstellung des Gebietsschemabezeichners (LCID). Es handelt sich um eine bis vier hexadezimale Ziffern ohne 0x-Präfix und ohne führende Nullen. Die LCID kann einen neutralen Unterlanguagebezeichner aufweisen.
`flags`	Dies ist optional. Die Zeichenfolgendarstellung der Typbibliothekskennzeichnungen für diese Typbibliothek. Insbesondere sollte es eine von "RESTRICTED", "CONTROL", "HIDDEN" und "HASDISKIMAGE" sein.

comClass

Das comClass Element ist ein optionales untergeordnetes Element des file Elements, ist jedoch erforderlich, wenn die ClickOnce-Anwendung eine COM-Komponente enthält, die mit registrierungsfreiem COM bereitgestellt werden soll. Das Element weist die folgenden Attribute auf.

Attribute	Description
`clsid`	Required. Die Klassen-ID der COM-Komponente, ausgedrückt als GUID.
`description`	Dies ist optional. Der Klassenname.
`threadingModel`	Dies ist optional. Das threadingmodell, das von in prozessinternen COM-Klassen verwendet wird. Wenn diese Eigenschaft null ist, wird kein Threadingmodell verwendet. Die Komponente wird im Hauptthread des Clients erstellt und Aufrufe von anderen Threads werden an diesen Thread gemarstet. In der folgenden Liste sind die gültigen Werte aufgeführt: `Apartment`, `Free`, `Both` und `Neutral`.
`tlbid`	Dies ist optional. GUID für die Typbibliothek für diese COM-Komponente.
`progid`	Dies ist optional. Versionsabhängiger programmgesteuerter Bezeichner, der der COM-Komponente zugeordnet ist. Das Format einer `ProgID` ist `<vendor>.<component>.<version>`.
`miscStatus`	Dies ist optional. Dupliziert im Assemblymanifest die vom `MiscStatus` Registrierungsschlüssel bereitgestellten Informationen. Wenn Werte für die `miscStatusIcon`fehlenden `miscStatusDocprintmiscStatusContentmiscStatusThumbnail` Attribute nicht gefunden werden, wird der in der Liste aufgeführte `miscStatus` Standardwert für die fehlenden Attribute verwendet. Der Wert kann eine durch Trennzeichen getrennte Liste der Attributwerte aus der folgenden Tabelle sein. Sie können dieses Attribut verwenden, wenn es sich bei der COM-Klasse um eine OCX-Klasse handelt, die Registrierungsschlüsselwerte erfordert `MiscStatus` .
`miscStatusIcon`	Dies ist optional. Duplikate im Assemblymanifest, die von DVASPECT_ICON bereitgestellten Informationen. Es kann ein Symbol eines Objekts bereitstellen. Der Wert kann eine durch Trennzeichen getrennte Liste der Attributwerte aus der folgenden Tabelle sein. Sie können dieses Attribut verwenden, wenn es sich bei der COM-Klasse um eine OCX-Klasse handelt, die Registrierungsschlüsselwerte erfordert `Miscstatus` .
`miscStatusContent`	Dies ist optional. Duplikate im Assemblymanifest, die von DVASPECT_CONTENT bereitgestellten Informationen. Es kann ein zusammengesetztes Dokument bereitstellen, das für einen Bildschirm oder Drucker angezeigt werden kann. Der Wert kann eine durch Trennzeichen getrennte Liste der Attributwerte aus der folgenden Tabelle sein. Sie können dieses Attribut verwenden, wenn es sich bei der COM-Klasse um eine OCX-Klasse handelt, die Registrierungsschlüsselwerte erfordert `MiscStatus` .
`miscStatusDocPrint`	Dies ist optional. Duplikate im Assemblymanifest, die von DVASPECT_DOCPRINT bereitgestellten Informationen. Sie kann eine Objektdarstellung bereitstellen, die auf dem Bildschirm angezeigt werden kann, als ob sie auf einen Drucker gedruckt wird. Der Wert kann eine durch Trennzeichen getrennte Liste der Attributwerte aus der folgenden Tabelle sein. Sie können dieses Attribut verwenden, wenn es sich bei der COM-Klasse um eine OCX-Klasse handelt, die Registrierungsschlüsselwerte erfordert `MiscStatus` .
`miscStatusThumbnail`	Dies ist optional. Dupliziert in einem Assemblymanifest die informationen, die von DVASPECT_THUMBNAIL bereitgestellt werden. Sie kann eine Miniaturansicht eines Objekts bereitstellen, das in einem Browsertool angezeigt werden kann. Der Wert kann eine durch Trennzeichen getrennte Liste der Attributwerte aus der folgenden Tabelle sein. Sie können dieses Attribut verwenden, wenn es sich bei der COM-Klasse um eine OCX-Klasse handelt, die Registrierungsschlüsselwerte erfordert `MiscStatus` .

comInterfaceExternalProxyStub

Das comInterfaceExternalProxyStub Element ist ein optionales untergeordnetes Element des file Elements, kann jedoch erforderlich sein, wenn die ClickOnce-Anwendung eine COM-Komponente enthält, die sie mithilfe von registrierungsfreiem COM bereitstellen möchte. Das Element enthält die folgenden Attribute.

Attribute	Description
`iid`	Required. Die Schnittstellen-ID (IID), die von diesem Proxy bereitgestellt wird. Die IID muss geschweifte Klammern umgeben haben.
`baseInterface`	Dies ist optional. Die IID der Schnittstelle, von der die Schnittstelle abgeleitet wird, auf die verwiesen `iid` wird.
`numMethods`	Dies ist optional. Die Anzahl der von der Schnittstelle implementierten Methoden.
`name`	Dies ist optional. Der Name der Schnittstelle, wie sie im Code angezeigt wird.
`tlbid`	Dies ist optional. Die Typbibliothek, die die Beschreibung der vom `iid` Attribut angegebenen Schnittstelle enthält.
`proxyStubClass32`	Dies ist optional. Ordnet eine IID einer CLSID in 32-Bit-Proxy-DLLs zu.

comInterfaceProxyStub

Das comInterfaceProxyStub Element ist ein optionales untergeordnetes Element des file Elements, kann jedoch erforderlich sein, wenn die ClickOnce-Anwendung eine COM-Komponente enthält, die sie mithilfe von registrierungsfreiem COM bereitstellen möchte. Das Element enthält die folgenden Attribute.

Attribute	Description
`iid`	Required. Die Schnittstellen-ID (IID), die von diesem Proxy bereitgestellt wird. Die IID muss geschweifte Klammern umgeben haben.
`baseInterface`	Dies ist optional. Die IID der Schnittstelle, von der die Schnittstelle abgeleitet wird, auf die verwiesen `iid` wird.
`numMethods`	Dies ist optional. Die Anzahl der von der Schnittstelle implementierten Methoden.
`Name`	Dies ist optional. Der Name der Schnittstelle, wie sie im Code angezeigt wird.
`Tlbid`	Dies ist optional. Die Typbibliothek, die die Beschreibung der vom `iid` Attribut angegebenen Schnittstelle enthält.
`proxyStubClass32`	Dies ist optional. Ordnet eine IID einer CLSID in 32-Bit-Proxy-DLLs zu.
`threadingModel`	Dies ist optional. Dies ist optional. Das threadingmodell, das von in prozessinternen COM-Klassen verwendet wird. Wenn diese Eigenschaft null ist, wird kein Threadingmodell verwendet. Die Komponente wird im Hauptthread des Clients erstellt und Aufrufe von anderen Threads werden an diesen Thread gemarstet. In der folgenden Liste sind die gültigen Werte aufgeführt: `Apartment`, `Free`, `Both` und `Neutral`.

windowClass

Das windowClass Element ist ein optionales untergeordnetes Element des file Elements, kann jedoch erforderlich sein, wenn die ClickOnce-Anwendung eine COM-Komponente enthält, die sie mithilfe von registrierungsfreiem COM bereitstellen möchte. Das Element bezieht sich auf eine von der COM-Komponente definierte Fensterklasse, die eine Version darauf angewendet haben muss. Das Element enthält die folgenden Attribute.

Attribute Description

versioned Dies ist optional. Steuert, ob der in der Registrierung verwendete name der internen Fensterklasse die Version der Assembly enthält, die die Fensterklasse enthält. Der Wert dieses Attributs kann sein yes oder no. Der Standardwert lautet yes. Der Wert no sollte nur verwendet werden, wenn die gleiche Fensterklasse durch eine parallele Komponente und eine entsprechende nicht parallele Komponente definiert wird und Sie sie als dieselbe Fensterklasse behandeln möchten. Beachten Sie, dass die üblichen Regeln für die Registrierung von Fensterklassen gelten – nur die erste Komponente, die die Fensterklasse registriert, kann sie registrieren, da sie nicht über eine Version verfügt.

Attribute	Description
`versioned`	Dies ist optional. Steuert, ob der in der Registrierung verwendete name der internen Fensterklasse die Version der Assembly enthält, die die Fensterklasse enthält. Der Wert dieses Attributs kann sein `yes` oder `no`. Der Standardwert lautet `yes`. Der Wert `no` sollte nur verwendet werden, wenn die gleiche Fensterklasse durch eine parallele Komponente und eine entsprechende nicht parallele Komponente definiert wird und Sie sie als dieselbe Fensterklasse behandeln möchten. Beachten Sie, dass die üblichen Regeln für die Registrierung von Fensterklassen gelten – nur die erste Komponente, die die Fensterklasse registriert, kann sie registrieren, da sie nicht über eine Version verfügt.

Hash

Das hash Element ist ein optionales untergeordnetes Element des file Elements. Das hash Element hat keine Attribute.

ClickOnce verwendet einen algorithmischen Hash aller Dateien in einer Anwendung als Sicherheitsüberprüfung, um sicherzustellen, dass keine der Dateien nach der Bereitstellung geändert wurde. Wenn das hash Element nicht enthalten ist, wird diese Überprüfung nicht ausgeführt. Daher wird das Weglassen des hash Elements nicht empfohlen.

Wenn ein Manifest eine Datei enthält, die nicht hashed ist, kann dieses Manifest nicht digital signiert werden, da Benutzer den Inhalt einer nicht synchronisierten Datei nicht überprüfen können.

dsig:Transforms

Das dsig:Transforms Element ist ein erforderliches untergeordnetes Element des hash Elements. Das dsig:Transforms Element hat keine Attribute.

dsig:Transform

Das dsig:Transform Element ist ein erforderliches untergeordnetes Element des dsig:Transforms Elements. Das dsig:Transform Element weist die folgenden Attribute auf.

Attribute	Description
`Algorithm`	Der Algorithmus, der zum Berechnen des Digests für diese Datei verwendet wird. Derzeit ist der einzige wert, der von ClickOnce verwendet wird `urn:schemas-microsoft-com:HashTransforms.Identity`.

dsig:DigestMethod

Das dsig:DigestMethod Element ist ein erforderliches untergeordnetes Element des hash Elements. Das dsig:DigestMethod Element weist die folgenden Attribute auf.

Attribute	Description
`Algorithm`	Der Algorithmus, der zum Berechnen des Digests für diese Datei verwendet wird. Derzeit ist der einzige wert, der von ClickOnce verwendet wird `http://www.w3.org/2000/09/xmldsig#sha1`.

dsig:DigestValue

Das dsig:DigestValue Element ist ein erforderliches untergeordnetes Element des hash Elements. Das dsig:DigestValue Element hat keine Attribute. Der Textwert ist der berechnete Hash für die angegebene Datei.

Hinweise

Dieses Element identifiziert alle Nichtassembly-Dateien, aus denen die Anwendung besteht, und insbesondere die Hashwerte für die Dateiüberprüfung. Dieses Element kann auch Com-Isolationsdaten (Component Object Model) enthalten, die der Datei zugeordnet sind. Wenn sich eine Datei ändert, muss die Anwendungsmanifestdatei ebenfalls aktualisiert werden, um die Änderung widerzuspiegeln.

Beispiel

Im folgenden Codebeispiel werden file Elemente in einem Anwendungsmanifest für eine Anwendung veranschaulicht, die mithilfe von ClickOnce bereitgestellt wird.

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

Siehe auch

ClickOnce-Anwendungsmanifest

Feedback

War diese Seite hilfreich?

Last updated on 2026-08-28