Elemento <file> (applicazione ClickOnce)

Articolo
08/11/2011

Identifica tutti i file non assembly scaricati e utilizzati dall'applicazione.

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

Elementi e attributi

L'elemento file è facoltativo. e dispone degli attributi riportati di seguito.

Attribute	Oggetto di descrizione
name	Obbligatoria. Identifica il nome del file.
size	Obbligatoria. Specifica la dimensione, in byte, del file.
group	Facoltativo, se l'attributo optional non è specificato o è impostato su false. Obbligatorio se l'attributo optional è impostato su true. Nome del gruppo a cui appartiene il file. Il nome può essere un qualsiasi valore stringa Unicode scelto dallo sviluppatore e viene utilizzato per il download di file su richiesta con la classe ApplicationDeployment.
optional	Facoltativo. Specifica se il file deve essere scaricato alla prima esecuzione dell'applicazione o se deve rimanere solo sul server fino a quando non viene richiesto dall'applicazione. Se l'attributo è impostato su false o non è definito, il file viene scaricato al momento dell'installazione o della prima esecuzione dell'applicazione. Se true, è necessario specificare un group affinché il manifesto dell'applicazione sia valido. optional non può essere impostato su true se viene specificato l'attributo writeableType con il valore applicationData.
writeableType	Facoltativo. Specifica se il file è un file di dati. L'unico valore attualmente valido è applicationData.

typelib

typelib è un elemento figlio facoltativo dell'elemento file. Questo elemento descrive la libreria dei tipi che appartiene al componente COM e e dispone degli attributi riportati di seguito.

Attribute	Oggetto di descrizione
tlbid	Obbligatoria. GUID assegnato alla libreria dei tipi.
version	Obbligatoria. Numero di versione della libreria dei tipi.
helpdir	Obbligatoria. Directory contenente i file della Guida relativi al componente. Può essere di lunghezza zero.
resourceid	Facoltativo. Rappresentazione in forma di stringa esadecimale dell'ID impostazioni locali (LCID). È composto da 1 a 4 cifre esadecimali e non contiene il prefisso 0x né zero iniziali. Al valore LCID può essere associato un identificatore della sottolingua neutral.
flags	Facoltativo. Rappresentazione in forma di stringa dei flag relativi a questa libreria dei tipi. In particolare, questo attributo deve corrispondere a uno dei seguenti valori: "RESTRICTED", "CONTROL", "HIDDEN", "HASDISKIMAGE".

comClass

comClass è un elemento figlio facoltativo dell'elemento file, ma è obbligatorio se l'applicazione ClickOnce contiene un componente COM che si desidera distribuire mediante componenti COM senza registrazione. e dispone degli attributi riportati di seguito.

Attribute	Oggetto di descrizione
clsid	Obbligatoria. ID classe del componente COM espresso come GUID.
description	Facoltativo. Nome della classe.
threadingModel	Facoltativo. Modello di threading utilizzato dalle classi COM in-process. Se questa proprietà è null, non verrà utilizzato alcun modello di threading. Il componente viene creato sul thread principale del client e per le chiamate provenienti dagli altri thread verrà eseguito il marshalling su questo thread. Di seguito sono elencati i valori validi: Apartment, Free, Both e Neutral.
tlbid	Facoltativo. GUID della libreria dei tipi per questo componente COM.
progid	Facoltativo. Identificatore a livello di codice dipendente dalla versione associato al componente COM. Il formato di ProgID è <vendor>.<component>.<version>.
miscStatus	Facoltativo. Duplica nel manifesto dell'assembly le informazioni fornite dalla chiave del Registro di sistema MiscStatus. Se i valori degli attributi miscStatusIcon, miscStatusContent, miscStatusDocprint o miscStatusThumbnail non vengono trovati, per gli attributi mancanti verrà utilizzato il valore predefinito corrispondente elencato in miscStatus. Il valore può essere un elenco delimitato da virgole dei valori degli attributi ricavati dalla seguente tabella. È possibile utilizzare questo attributo se la classe COM è una classe OCX che richiede valori per la chiave del Registro di sistema MiscStatus.
miscStatusIcon	Facoltativo. Duplica nel manifesto dell'assembly le informazioni fornite da DVASPECT_ICON. Consente di specificare un'icona di un oggetto. Il valore può essere un elenco delimitato da virgole dei valori degli attributi ricavati dalla seguente tabella. È possibile utilizzare questo attributo se la classe COM è una classe OCX che richiede valori per la chiave del Registro di sistema Miscstatus.
miscStatusContent	Facoltativo. Duplica nel manifesto dell'assembly le informazioni fornite da DVASPECT_CONTENT. Consente di fornire un documento composito visualizzabile per uno schermo o una stampante. Il valore può essere un elenco delimitato da virgole dei valori degli attributi ricavati dalla seguente tabella. È possibile utilizzare questo attributo se la classe COM è una classe OCX che richiede valori per la chiave del Registro di sistema MiscStatus.
miscStatusDocPrint	Facoltativo. Duplica nel manifesto dell'assembly le informazioni fornite da DVASPECT_DOCPRINT. Consente di fornire una rappresentazione in forma di oggetto visualizzabile sullo schermo come se fosse inviata a una stampante. Il valore può essere un elenco delimitato da virgole dei valori degli attributi ricavati dalla seguente tabella. È possibile utilizzare questo attributo se la classe COM è una classe OCX che richiede valori per la chiave del Registro di sistema MiscStatus.
miscStatusThumbnail	Facoltativo. Duplica nel manifesto dell'assembly le informazioni fornite da DVASPECT_THUMBNAIL. Consente di fornire un'anteprima di un oggetto visualizzabile in uno strumento di visualizzazione. Il valore può essere un elenco delimitato da virgole dei valori degli attributi ricavati dalla seguente tabella. È possibile utilizzare questo attributo se la classe COM è una classe OCX che richiede valori per la chiave del Registro di sistema MiscStatus.

comInterfaceExternalProxyStub

comInterfaceExternalProxyStub è un elemento figlio facoltativo dell'elemento file, ma può essere obbligatorio se l'applicazione ClickOnce contiene un componente COM che si desidera distribuire mediante componenti COM senza registrazione. L'elemento contiene i seguenti attributi.

Attribute	Oggetto di descrizione
iid	Obbligatoria. ID interfaccia (IID) servito da questo proxy. Il valore IID deve essere specificato tra parentesi quadre.
baseInterface	Facoltativo. IID dell'interfaccia da cui è derivata l'interfaccia indicata da iid.
numMethods	Facoltativo. Numero di metodi implementati dall'interfaccia.
name	Facoltativo. Nome dell'interfaccia che verrà visualizzato nel codice.
tlbid	Facoltativo. Libreria dei tipi che contiene la descrizione dell'interfaccia specificata dall'attributo iid.
proxyStubClass32	Facoltativo. Mappa un IID a un CLSID nelle DLL proxy a 32 bit.

comInterfaceProxyStub

comInterfaceProxyStub è un elemento figlio facoltativo dell'elemento file, ma può essere obbligatorio se l'applicazione ClickOnce contiene un componente COM che si desidera distribuire mediante componenti COM senza registrazione. L'elemento contiene i seguenti attributi.

Attribute	Oggetto di descrizione
iid	Obbligatoria. ID interfaccia (IID) servito da questo proxy. Il valore IID deve essere specificato tra parentesi quadre.
baseInterface	Facoltativo. IID dell'interfaccia da cui è derivata l'interfaccia indicata da iid.
numMethods	Facoltativo. Numero di metodi implementati dall'interfaccia.
Name	Facoltativo. Nome dell'interfaccia che verrà visualizzato nel codice.
Tlbid	Facoltativo. Libreria dei tipi che contiene la descrizione dell'interfaccia specificata dall'attributo iid.
proxyStubClass32	Facoltativo. Mappa un IID a un CLSID nelle DLL proxy a 32 bit.
threadingModel	Facoltativo. Facoltativo. Modello di threading utilizzato dalle classi COM in-process. Se questa proprietà è null, non verrà utilizzato alcun modello di threading. Il componente viene creato sul thread principale del client e per le chiamate provenienti dagli altri thread verrà eseguito il marshalling su questo thread. Di seguito sono elencati i valori validi: Apartment, Free, Both e Neutral.

windowClass

windowClass è un elemento figlio facoltativo dell'elemento file, ma può essere obbligatorio se l'applicazione ClickOnce contiene un componente COM che si desidera distribuire mediante componenti COM senza registrazione. L'elemento si riferisce a una classe finestra definita dal componente COM a cui deve essere applicata una versione. L'elemento contiene i seguenti attributi.

Attribute	Oggetto di descrizione
versioned	Facoltativo. Controlla se il nome della classe finestra interno utilizzato nella registrazione contiene la versione dell'assembly contenente la classe finestra. Il valore di questo attributo può essere yes o no. Il valore predefinito è yes. Il valore no deve essere utilizzato solo se la stessa classe finestra è definita da un componente affiancato e da un componente equivalente non affiancato e si desidera considerare tali componenti come se fossero la stessa classe finestra. Tenere presente che per la registrazione della classe finestra valgono le solite regole, ovvero soltanto il primo componente che registra la classe finestra sarà in grado di eseguire la registrazione, poiché ad esso non è applicata alcuna versione.

versioned

Facoltativo. Controlla se il nome della classe finestra interno utilizzato nella registrazione contiene la versione dell'assembly contenente la classe finestra. Il valore di questo attributo può essere yes o no. Il valore predefinito è yes. Il valore no deve essere utilizzato solo se la stessa classe finestra è definita da un componente affiancato e da un componente equivalente non affiancato e si desidera considerare tali componenti come se fossero la stessa classe finestra. Tenere presente che per la registrazione della classe finestra valgono le solite regole, ovvero soltanto il primo componente che registra la classe finestra sarà in grado di eseguire la registrazione, poiché ad esso non è applicata alcuna versione.

hash

hash è un elemento figlio facoltativo dell'elemento file. L'elemento hash non contiene attributi.

ClickOnce utilizza un hash algoritmico di tutti i file contenuti in un'applicazione come controllo di sicurezza per garantire che nessun file venga modificato dopo la distribuzione. Se l'elemento hash non viene incluso, questo controllo non verrà eseguito. Pertanto, non è consigliabile omettere l'elemento hash.

Se un manifesto contiene un file senza hash, non è possibile applicarvi una firma digitale, perché gli utenti non possono verificare il contenuto di un file senza hash.

dsig:Transforms

L'elemento dsig:Transforms è un elemento figlio obbligatorio di hash. L'elemento dsig:Transforms non contiene attributi.

dsig:Transform

L'elemento dsig:Transform è un elemento figlio obbligatorio di dsig:Transforms. L'elemento dsig:Transform dispone dei seguenti attributi.

Attribute	Oggetto di descrizione
Algorithm	Algoritmo usato per calcolare la classificazione di questo file. L'unico valore attualmente utilizzato da ClickOnce è urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

L'elemento dsig:DigestMethod è un elemento figlio obbligatorio di hash. L'elemento dsig:DigestMethod dispone dei seguenti attributi.

Attribute	Oggetto di descrizione
Algorithm	Algoritmo usato per calcolare la classificazione di questo file. L'unico valore attualmente utilizzato da ClickOnce è http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValue

L'elemento dsig:DigestValue è un elemento figlio obbligatorio di hash. L'elemento dsig:DigestValue non contiene attributi. Il relativo valore di testo rappresenta l'hash calcolato per il file specificato.

Note

Questo elemento identifica tutti i file non assembly che costituiscono l'applicazione e, in particolare, i valori hash per la verifica dei file. Può inoltre contenere i dati sull'isolamento COM (Component Object Model) associati al file. Se un file viene modificato, anche il file manifesto dell'applicazione dovrà essere aggiornato in base a tale modifica.

Esempio

Nell'esempio di codice seguente vengono illustrati gli elementi file in un manifesto per un'applicazione distribuita mediante 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>

Vedere anche

Riferimenti

Manifesto dell'applicazione ClickOnce

Condividi tramite