<elemento file> (applicazione ClickOnce)

Articolo
01/12/2024

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 `miscStatusIcon`attributi , `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.

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

Manifesto dell'applicazione ClickOnce

Condividi tramite