<elemento file> (applicazione ClickOnce)

Identifica tutti i file nonassembly scaricati e usati dall'applicazione.

Sintassi

<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. L'elemento presenta gli attributi seguenti.

Attributo Descrizione
name Obbligatorio. Identifica il nome del file.
size Obbligatorio. Specifica le dimensioni, in byte, del file.
group Facoltativo, se l'attributo optional non è specificato o impostato su false; obbligatorio se optional è true. Nome del gruppo a cui appartiene il file. Il nome può essere qualsiasi valore stringa Unicode scelto dallo sviluppatore e viene usato per scaricare i file su richiesta con la ApplicationDeployment classe .
optional Facoltativo. Specifica se questo file deve essere scaricato quando l'applicazione viene eseguita per la prima volta o se il file deve risiedere solo nel server fino a quando l'applicazione non lo richiede su richiesta. Se false o non definito, il file viene scaricato quando l'applicazione viene eseguita o installata per la prima volta. Se true, è necessario specificare un group oggetto affinché il manifesto dell'applicazione sia valido. optional non può essere true se writeableType è specificato con il valore applicationData.
writeableType Facoltativo. Specifica che questo file è un file di dati. Attualmente, l'unico valore valido è applicationData.

typelib

L'elemento typelib è un elemento figlio facoltativo dell'elemento file. L'elemento descrive la libreria dei tipi che appartiene al componente COM. L'elemento presenta gli attributi seguenti.

Attributo Descrizione
tlbid Obbligatorio. GUID assegnato alla libreria dei tipi.
version Obbligatorio. Numero di versione della libreria dei tipi.
helpdir Obbligatorio. Directory contenente i file della Guida per il componente. Può essere di lunghezza zero.
resourceid Facoltativo. Rappresentazione di stringa esadecimale dell'identificatore delle impostazioni locali (LCID). Si tratta di una o quattro cifre esadecimali senza un prefisso 0x e senza zeri iniziali. LCID può avere un identificatore di sottolanguage neutro.
flags Facoltativo. Rappresentazione di stringa dei flag della libreria dei tipi per questa libreria dei tipi. In particolare, deve essere uno dei "RESTRICTED", "CONTROL", "HIDDEN" e "HASDISKIMAGE".

comClass

L'elemento comClass è un elemento figlio facoltativo dell'elemento file , ma è obbligatorio se l'applicazione ClickOnce contiene un componente COM che intende distribuire tramite COM senza registrazione. L'elemento presenta gli attributi seguenti.

Attributo Descrizione
clsid Obbligatorio. 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 viene usato alcun modello di threading. Il componente viene creato nel thread principale del client e le chiamate da altri thread vengono sottoposto a marshalling a questo thread. L'elenco seguente mostra i valori validi:

Apartment, Free, Both e Neutral.
tlbid Facoltativo. GUID per la libreria dei tipi per questo componente COM.
progid Facoltativo. Identificatore programmatico dipendente dalla versione associato al componente COM. Il formato di un ProgID oggetto è <vendor>.<component>.<version>.
miscStatus Facoltativo. Duplicati nel manifesto dell'assembly le informazioni fornite dalla chiave del MiscStatus Registro di sistema. Se i valori per gli miscStatusIconattributi , miscStatusContentmiscStatusDocprint, o miscStatusThumbnail non vengono trovati, viene usato il valore predefinito corrispondente elencato in miscStatus per gli attributi mancanti. Il valore può essere un elenco delimitato da virgole dei valori dell'attributo della tabella seguente. È possibile utilizzare questo attributo se la classe COM è una classe OCX che richiede MiscStatus valori di chiave del Registro di sistema.
miscStatusIcon Facoltativo. Duplicati nel manifesto dell'assembly le informazioni fornite da DVASPECT_ICON. Può fornire un'icona di un oggetto. Il valore può essere un elenco delimitato da virgole dei valori dell'attributo della tabella seguente. È possibile utilizzare questo attributo se la classe COM è una classe OCX che richiede Miscstatus valori di chiave del Registro di sistema.
miscStatusContent Facoltativo. Duplicati nel manifesto dell'assembly le informazioni fornite da DVASPECT_CONTENT. Può fornire un documento composto visualizzabile per uno schermo o una stampante. Il valore può essere un elenco delimitato da virgole dei valori dell'attributo della tabella seguente. È possibile utilizzare questo attributo se la classe COM è una classe OCX che richiede MiscStatus valori di chiave del Registro di sistema.
miscStatusDocPrint Facoltativo. Duplicati nel manifesto dell'assembly le informazioni fornite da DVASPECT_DOCPRINT. Può fornire una rappresentazione dell'oggetto visualizzabile sullo schermo come se stampata su una stampante. Il valore può essere un elenco delimitato da virgole dei valori dell'attributo della tabella seguente. È possibile utilizzare questo attributo se la classe COM è una classe OCX che richiede MiscStatus valori di chiave del Registro di sistema.
miscStatusThumbnail Facoltativo. Duplicati in un manifesto dell'assembly le informazioni fornite da DVASPECT_THUMBNAIL. Può fornire un'anteprima di un oggetto visualizzabile in uno strumento di esplorazione. Il valore può essere un elenco delimitato da virgole dei valori dell'attributo della tabella seguente. È possibile utilizzare questo attributo se la classe COM è una classe OCX che richiede MiscStatus valori di chiave del Registro di sistema.

comInterfaceExternalProxyStub

L'elemento comInterfaceExternalProxyStub è un elemento figlio facoltativo dell'elemento file , ma può essere necessario se l'applicazione ClickOnce contiene un componente COM che intende distribuire tramite COM senza registrazione. L'elemento contiene gli attributi seguenti.

Attributo Descrizione
iid Obbligatorio. ID interfaccia (IID) gestito da questo proxy. L'IID deve avere parentesi graffe che lo circondano.
baseInterface Facoltativo. IID dell'interfaccia da cui deriva l'interfaccia a cui fa iid riferimento.
numMethods Facoltativo. Numero di metodi implementati dall'interfaccia.
name Facoltativo. Nome dell'interfaccia come verrà visualizzato nel codice.
tlbid Facoltativo. Libreria dei tipi che contiene la descrizione dell'interfaccia specificata dall'attributo iid .
proxyStubClass32 Facoltativo. Mappe un IID a un CLSID in DLL proxy a 32 bit.

comInterfaceProxyStub

L'elemento comInterfaceProxyStub è un elemento figlio facoltativo dell'elemento file , ma può essere necessario se l'applicazione ClickOnce contiene un componente COM che intende distribuire tramite COM senza registrazione. L'elemento contiene gli attributi seguenti.

Attributo Descrizione
iid Obbligatorio. ID interfaccia (IID) gestito da questo proxy. L'IID deve avere parentesi graffe che lo circondano.
baseInterface Facoltativo. IID dell'interfaccia da cui deriva l'interfaccia a cui fa iid riferimento.
numMethods Facoltativo. Numero di metodi implementati dall'interfaccia.
Name Facoltativo. Nome dell'interfaccia come verrà visualizzato nel codice.
Tlbid Facoltativo. Libreria dei tipi che contiene la descrizione dell'interfaccia specificata dall'attributo iid .
proxyStubClass32 Facoltativo. Mappe un IID a un CLSID in DLL proxy a 32 bit.
threadingModel Facoltativo. Facoltativo. Modello di threading utilizzato dalle classi COM in-process. Se questa proprietà è null, non viene usato alcun modello di threading. Il componente viene creato nel thread principale del client e le chiamate da altri thread vengono sottoposto a marshalling a questo thread. L'elenco seguente mostra i valori validi:

Apartment, Free, Both e Neutral.

windowClass

L'elemento windowClass è un elemento figlio facoltativo dell'elemento file , ma può essere necessario se l'applicazione ClickOnce contiene un componente COM che intende distribuire tramite COM senza registrazione. L'elemento fa riferimento a una classe finestra definita dal componente COM che deve avere una versione applicata. L'elemento contiene gli attributi seguenti.

Attributo Descrizione
versioned Facoltativo. Controlla se il nome della classe della finestra interna utilizzata nella registrazione contiene la versione dell'assembly che contiene la classe window. Il valore di questo attributo può essere yes o no. Il valore predefinito è yes. Il valore no deve essere usato solo se la stessa classe finestra è definita da un componente affiancato e da un componente non affiancato equivalente e si desidera considerarli come la stessa classe di finestra. Si noti che si applicano le regole consuete relative alla registrazione della classe finestra, ma solo il primo componente che registra la classe della finestra sarà in grado di registrarlo, perché non dispone di una versione applicata.

hash

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

ClickOnce usa un hash algoritmico di tutti i file in un'applicazione come controllo di sicurezza, per assicurarsi che nessuno dei file sia stato modificato dopo la distribuzione. Se l'elemento hash non è incluso, questo controllo non verrà eseguito. Pertanto, l'omissione dell'elemento hash non è consigliata.

Se un manifesto contiene un file non con hash, tale manifesto non può essere firmato digitalmente, perché gli utenti non possono verificare il contenuto di un file senzaash.

dsig:Transforms

L'elemento dsig:Transforms è un elemento figlio obbligatorio dell'elemento hash . L'elemento dsig:Transforms non ha attributi.

dsig:Transform

L'elemento dsig:Transform è un elemento figlio obbligatorio dell'elemento dsig:Transforms . L'elemento dsig:Transform presenta gli attributi seguenti.

Attributo Descrizione
Algorithm Algoritmo utilizzato per calcolare il digest per questo file. Attualmente l'unico valore usato da ClickOnce è urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

L'elemento dsig:DigestMethod è un elemento figlio obbligatorio dell'elemento hash . L'elemento dsig:DigestMethod presenta gli attributi seguenti.

Attributo Descrizione
Algorithm Algoritmo utilizzato per calcolare il digest per questo file. Attualmente l'unico valore usato da ClickOnce è http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValue

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

Osservazioni:

Questo elemento identifica tutti i file nonassembly che costituiscono l'applicazione e, in particolare, i valori hash per la verifica dei file. Questo elemento può includere anche i dati di isolamento COM (Component Object Model) associati al file. Se un file viene modificato, è necessario aggiornare anche il file manifesto dell'applicazione per riflettere la modifica.

Esempio

L'esempio di codice seguente illustra gli file elementi in un manifesto dell'applicazione per un'applicazione distribuita usando 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>

Vedi anche