<elemento file> (applicazione ClickOnce)
Identifica tutti i file nonassembly scaricati e usati 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>
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 . |
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". |
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 , miscStatusContent miscStatusDocprint , 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. |
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. |
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 . |
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. |
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.
L'elemento dsig:Transforms
è un elemento figlio obbligatorio dell'elemento hash
. L'elemento dsig:Transforms
non ha attributi.
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 . |
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 . |
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.
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.
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>