Freigeben über

<file>-Element (ClickOnce-Anwendung)

  • Artikel

Es identifiziert alle nicht zusammengesetzten 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 folgende Attribute auf.

Attribut BESCHREIBUNG
name Erforderlich. Gibt den Namen der Datei an.
size Erforderlich. Gibt die Dateigröße in Byte an.
group Optional, wenn das optional-Attribut nicht angegeben oder auf falsefestgelegt ist; erforderlich, wenn optionaltrue ist. Der Name der Gruppe, der diese Datei angehört. Der Name kann ein beliebiger Unicode-Zeichenfolgenwert sein, der vom Entwickler ausgewählt wurde, und wird zum bedarfsgesteuerten Herunterladen von Dateien mit der ApplicationDeployment-Klasse verwendet.
optional Optional. Gibt an, ob diese Datei heruntergeladen werden muss, wenn die Anwendung zum ersten Mal ausgeführt wird, oder ob sich die Datei nur auf dem Server befinden soll, bis die Anwendung sie bei Bedarf anfordert. Wenn false oder undefiniert, wird die Datei heruntergeladen, wenn die Anwendung zum ersten Mal ausgeführt oder installiert wird. Wenn true, muss group angegeben werden, damit das Anwendungsmanifest gültig ist. optional kann nicht wahr sein, wenn writeableType mit dem Wert applicationData angegeben wird.
writeableType 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 file-Elements. Das Element beschreibt die Typbibliothek, die zur COM-Komponente gehört. Das Element weist folgende Attribute auf.

Attribut BESCHREIBUNG
tlbid Erforderlich. Die GUID, die der Typbibliothek zugewiesen ist.
version Erforderlich. Die Versionsnummer der Typbibliothek.
helpdir Erforderlich. Das Verzeichnis, das die Hilfedateien für die Komponente enthält. Kann die Länge 0 (null) aufweisen.
resourceid Optional. Die hexadezimale Zeichenfolgendarstellung des Gebietsschemabezeichners (Locale Identifier, LCID). Es handelt sich um ein bis vier Hexadezimalstellen ohne Präfix 0x und ohne führende Nullen. Die LCID kann über einen neutralen Untersprachbezeichner verfügen.
flags Optional. Die Zeichenfolgendarstellung der Flags der Typbibliothek für diese Typbibliothek. Genauer gesagt: Es sollte sich um „RESTRICTED“, „CONTROL“, „HIDDEN“ oder „HASDISKIMAGE“ handeln.

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 mithilfe von COM ohne Registrierung bereitgestellt werden soll. Das Element weist folgende Attribute auf.

Attribut BESCHREIBUNG
clsid Erforderlich. Die Klassen-ID der COM-Komponente, die als GUID ausgedrückt wird.
description Optional. Der Name der Klasse.
threadingModel Optional. Das von prozessinternen COM-Klassen verwendete Threadingmodell. 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 gemarshallt. In der folgenden Liste werden die gültigen Werte aufgeführt:

Apartment, Free, Both und Neutral.
tlbid Optional. Die GUID für die Typbibliothek dieser Komponente.
progid Optional. Versionsabhängiger programmgesteuerter Bezeichner, der der COM-Komponente zugeordnet ist. Das Format einer ProgID ist <vendor>.<component>.<version>.
miscStatus Optional. Dupliziert im Assemblymanifest die Informationen, die vom MiscStatus-Registrierungsschlüssel bereitgestellt werden. Wenn Werte für die Attribute miscStatusIcon, miscStatusContent, miscStatusDocprintoder miscStatusThumbnail nicht gefunden werden, wird der entsprechende Standardwert, der in miscStatus aufgeführt ist, 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 die COM-Klasse eine OCX-Klasse ist, die MiscStatus-Registrierungsschlüsselwerte erfordert.
miscStatusIcon Optional. Dupliziert im Assemblymanifest die Informationen, die von DVASPECT_ICON bereitgestellt werden. 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 die COM-Klasse eine OCX-Klasse ist, die Miscstatus-Registrierungsschlüsselwerte erfordert.
miscStatusContent Optional. Dupliziert im Assemblymanifest die Informationen, die von DVASPECT_CONTENT bereitgestellt werden. Es kann ein Verbunddokument 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 die COM-Klasse eine OCX-Klasse ist, die MiscStatus-Registrierungsschlüsselwerte erfordert.
miscStatusDocPrint Optional. Dupliziert im Assemblymanifest die Informationen, die von DVASPECT_DOCPRINT bereitgestellt werden. Es kann eine Objektdarstellung bereitstellen, die auf dem Bildschirm angezeigt werden kann, als ob sie auf einem Drucker gedruckt würde. Der Wert kann eine durch Trennzeichen getrennte Liste der Attributwerte aus der folgenden Tabelle sein. Sie können dieses Attribut verwenden, wenn die COM-Klasse eine OCX-Klasse ist, die MiscStatus-Registrierungsschlüsselwerte erfordert.
miscStatusThumbnail Optional. Dupliziert in einem Assemblymanifest die Informationen, die von DVASPECT_THUMBNAIL bereitgestellt werden. Es 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 die COM-Klasse eine OCX-Klasse ist, die MiscStatus-Registrierungsschlüsselwerte erfordert.

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 mithilfe von COM ohne Registrierung bereitgestellt werden soll. Das Element enthält die folgenden Attribute.

Attribut BESCHREIBUNG
iid Erforderlich. Die Schnittstellen-ID (IID), die von diesem Proxy bereitgestellt wird. Die IID muss von geschweiften Klammern eingeschlossen sein.
baseInterface Optional. Die IID der Schnittstelle, von der die Schnittstelle, auf die von iid verwiesen wird, abgeleitet wird.
numMethods Optional. Die Anzahl der von der Schnittstelle implementierten Methoden.
name Optional. Der Name der Schnittstelle, wie sie im Code angezeigt wird.
tlbid Optional. Die Typbibliothek, die die Beschreibung der durch das iid-Attribut angegebenen Schnittstelle enthält.
proxyStubClass32 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 mithilfe von COM ohne Registrierung bereitgestellt werden soll. Das Element enthält die folgenden Attribute.

Attribut BESCHREIBUNG
iid Erforderlich. Die Schnittstellen-ID (IID), die von diesem Proxy bereitgestellt wird. Die IID muss von geschweiften Klammern eingeschlossen sein.
baseInterface Optional. Die IID der Schnittstelle, von der die Schnittstelle, auf die von iid verwiesen wird, abgeleitet wird.
numMethods Optional. Die Anzahl der von der Schnittstelle implementierten Methoden.
Name Optional. Der Name der Schnittstelle, wie sie im Code angezeigt wird.
Tlbid Optional. Die Typbibliothek, die die Beschreibung der durch das iid-Attribut angegebenen Schnittstelle enthält.
proxyStubClass32 Optional. Ordnet eine IID einer CLSID in 32-Bit-Proxy-DLLs zu.
threadingModel Optional. Optional. Das von prozessinternen COM-Klassen verwendete Threadingmodell. 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 gemarshallt. In der folgenden Liste werden 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 mithilfe von COM ohne Registrierung bereitgestellt werden soll. Das Element bezieht sich auf eine Fensterklasse, die von der COM-Komponente definiert wird und auf die eine Version angewendet werden muss. Das Element enthält die folgenden Attribute.

Attribut BESCHREIBUNG
versioned Optional. Steuert, ob der in der Registrierung verwendete interne Name der Fensterklasse die Version der Assembly aufweist, in der die Fensterklasse enthalten ist. Der Wert dieses Attributs kann yes oder nosein. Der Standardwert ist yes. Der Wert no sollte nur verwendet werden, wenn dieselbe Fensterklasse durch eine parallele Komponente und eine entsprechende nicht parallele Komponente definiert ist und Sie sie als dieselbe Fensterklasse behandeln möchten. Beachten Sie, dass die üblichen Regeln zur Registrierung von Fensterklassen gelten– nur die erste Komponente, die die Fensterklasse registriert, kann sie registrieren, da keine Version darauf angewendet wird.

hash

Das hash-Element ist ein optionales untergeordnetes Element des file-Elements. Das hash -Element weist keine Attribute auf.

ClickOnce verwendet einen algorithmischen Hashwert 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 durchgeführt. Daher wird das Auslassen des hash-Elements nicht empfohlen.

Wenn ein Manifest eine Datei ohne Hash enthält, kann dieses Manifest nicht digital signiert werden, da Benutzer*innen den Inhalt einer Datei ohne Hash nicht überprüfen können.

dsig:Transforms

Das dsig:Transforms-Element ist ein erforderliches untergeordnetes Element des hash-Elements. Das dsig:Transforms -Element weist keine Attribute auf.

dsig:Transform

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

Attribut BESCHREIBUNG
Algorithm Der Algorithmus, der zum Berechnen des Digests für diese Datei verwendet wird. Der derzeit einzige Wert, der von ClickOnce verwendet wird, ist 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 folgende Attribute auf.

Attribut BESCHREIBUNG
Algorithm Der Algorithmus, der zum Berechnen des Digests für diese Datei verwendet wird. Der derzeit einzige Wert, der von ClickOnce verwendet wird, ist 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 weist keine Attribute auf. Der Textwert ist der berechnete Hashwert für die angegebene Datei.

Bemerkungen

Dieses Element identifiziert alle nicht zusammengesetzten 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 auch die Anwendungsmanifestdatei aktualisiert werden, um die Änderung widerzuspiegeln.

Beispiel

Das folgende Codebeispiel veranschaulicht file-Elemente in einem Anwendungsmanifest für eine mit ClickOnce bereitgestellte Anwendung.

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

Weitere Informationen