Tabella file

La tabella file contiene un elenco completo dei file di origine con i relativi attributi, ordinati in base a un identificatore univoco, non localizzato. I file possono essere archiviati nel supporto di origine come singoli file o compressi all'interno di un file CAB. Per altre informazioni, vedere Using Cabinets and Compressed Sources.For more information, see Using Cabinets and Compressed Sources.

La tabella file contiene le colonne seguenti.

Colonna	Tipo	Chiave	Nullable
File	Identificatore	S	N
Componente_	Identificatore	N	N
FileName	Filename	N	N
FileSize	DoubleInteger	N	N
Versione	Versione	N	S
Linguaggio	Lingua	N	S
Attributi	Integer	N	S
Sequenza	Integer	N	N

 

Colonne

File

Token non localizzato che identifica in modo univoco il file. Questo campo non fa distinzione tra maiuscole e minuscole. Non assegnare identificatori a file diversi che differiscono solo per il caso.

Componente_

Chiave esterna nella prima colonna della tabella dei componenti. Questo campo identifica il componente che controlla il file.

Filename

Nome file utilizzato per l'installazione. Il nome può essere localizzato.

Poiché alcuni server Web possono fare distinzione tra maiuscole e minuscole, FileName deve corrispondere esattamente al caso dei file di origine per garantire il supporto dei download Internet.

Dimensione

Dimensioni del file, in byte. Deve essere un numero non negativo.

Versione

Questo campo è la stringa di versione per un file con versione. Questo campo è vuoto per i file senza versione. La versione del file immessa in questo campo deve essere identica alla versione del file incluso nel pacchetto di installazione.

Il campo Versione può anche essere impostato in modo da contenere la chiave primaria di un altro record nella tabella File. Il file a cui si fa riferimento determina quindi la logica di controllo delle versioni per questo file. Per altre informazioni, vedere File complementari. Si noti che se questo file è il percorso chiave per il relativo componente, non deve essere specificato come file complementare.

Lingua

Elenco di ID di lingua decimale separati da virgole.

I file di carattere non devono essere creati con un ID lingua, perché i tipi di carattere non dispongono di una risorsa ID lingua incorporata. Pertanto, questa colonna deve essere lasciata null per i file di carattere.

Attributi

Intero che contiene flag di bit che rappresentano gli attributi del file.

Nella tabella seguente viene illustrata la definizione del campo di bit.

Costante	Valore esadecimale	Decimal	Descrizione
msidbFileAttributesReadOnly	0x000001	1	Read-Only
msidbFileAttributesHidden	0x000002	2	Nascosto
msidbFileAttributesSystem	0x000004	4	Sistema
msidbFileAttributesVital	0x000200	512	Il file è fondamentale per il funzionamento accurato del componente a cui appartiene. Se l'installazione di un file con l'attributo msidbFileAttributesVital ha esito negativo, l'installazione viene arrestata e viene eseguito il rollback. In questo caso, il programma di installazione visualizza una finestra di dialogo senza un pulsante Ignora. Se questo attributo non è impostato e l'installazione del file ha esito negativo, il programma di installazione visualizza una finestra di dialogo con un pulsante Ignora. In questo caso, l'utente può scegliere di ignorare l'errore di installare il file e continuare.
msidbFileAttributesChecksum	0x000400	1024	Il file contiene un checksum valido. È necessario un checksum per ripristinare un file danneggiato.
msidbFileAttributesPatchAdded	0x001000	4096	Questo bit deve essere aggiunto solo da una patch e se il file viene aggiunto dalla patch.
msidbFileAttributesNoncompressed	0x002000	8192	Il tipo di origine del file non è compresso. Se impostato, ignorare la proprietà Riepilogo conteggio Word. Se non vengono impostati msidbFileAttributesNoncompressed o msidbFileAttributesCompressed, lo stato di compressione del file viene specificato dalla proprietà riepilogo conteggio Word. Non impostare sia msidbFileAttributesNoncompressed che msidbFileAttributesCompressed.
msidbFileAttributesCompressed	0x004000	16384	Il tipo di origine del file viene compresso. Se impostato, ignorare la proprietà Riepilogo conteggio Word. Se non vengono impostati msidbFileAttributesNoncompressed o msidbFileAttributesCompressed, lo stato di compressione del file viene specificato dalla proprietà riepilogo conteggio Word. Non impostare sia msidbFileAttributesNoncompressed che msidbFileAttributesCompressed.

 

Se il bit msidbFileAttributesVital all'interno della colonna Attributi è impostato e se il componente a cui appartiene il file è selezionato per l'installazione, il programma di installazione deve essere in grado di installare questo file per il completamento dell'installazione. Se il programma di installazione non è in grado di installare il file per qualche motivo (ad esempio, se il file di origine non può trovarsi all'interno dell'immagine di origine), verrà visualizzata una finestra di dialogo di errore con le opzioni "Riprova" o "Annulla". Per un file che non dispone di msidbFileAttributesVital , le opzioni in caso di errore di installazione saranno "Abort", "Retry" e "Ignore" (ovvero l'utente avrà la possibilità di completare l'installazione correttamente senza installare tale file).

Il bit msidbFileAttributesChecksum all'interno della colonna Attributi deve essere impostato per ogni file eseguibile nell'installazione con un checksum valido archiviato nell'intestazione file PE (Portable Eseguibile). Solo i file con questo set di bit verranno mai verificati per il checksum valido durante una reinstallazione. Per altre informazioni, vedere REINSTALLMODE.

Sequenza

Posizione della sequenza di questo file nelle immagini multimediali. Questo ordine deve corrispondere all'ordine dei file nel gabinetto se i file vengono compressi. Gli interi in questo campo devono essere uguali o maggiori di 1.

I numeri di sequenza nella colonna Sequence vengono usati per specificare sia l'ordine di installazione per i file che i supporti di origine in base al quale si trova il file (insieme alla tabella multimediale). Si supponga, ad esempio, che un file abbia un numero di sequenza pari a 92. Per determinare il disco di origine in cui si trova il file, cercare nella tabella Media la voce con il valore più piccolo di Last Sequence maggiore di 92.

Anche se i file compressi vengono assegnati numeri di sequenza interni all'interno di archivi, tali numeri assoluti non devono corrispondere ai numeri di sequenza all'interno della tabella File. È tuttavia importante che la sequenza di file nella tabella File sia identica alla sequenza dei file all'interno degli archivi.

Per i file non compressi, i numeri di sequenza non devono essere univoci. Ad esempio, se tutti i file non sono compressi e tutti risiedono su un disco, è possibile assegnare tutti i file allo stesso numero di sequenza.

Il limite massimo è 32767 file. Per creare un pacchetto di Windows Installer con altri file, vedere Creazione di un pacchetto di grandi dimensioni.

Commenti

Le azioni InstallFiles e RemoveFiles nelle tabelle di sequenza elaborano le informazioni contenute in questa tabella. Per informazioni sull'uso delle tabelle della sequenza, vedere Uso di una tabella sequenza.

La tabella viene inizialmente generata dall'elenco di file, ma se viene usata la compressione del cabinet, la tabella viene rigenerata dall'output del motore di compressione. Per altre informazioni, vedere File di archivio.

Per spostare un file esistente nel computer dell'utente durante l'installazione, usare l'azione MoveFiles Action e MoveFile Table. Per installare un file in più posizioni, usare l'azione DuplicateFiles e la tabella DuplicateFile.

Nella tabella seguente vengono riepilogate le possibili combinazioni di valori nella colonna Version e nella colonna Language. Per altre informazioni, vedere Regole di controllo delle versioni dei file.

Versione	Linguaggio	Descrizione
1.2.3.4	1033	Versione e lingua.
1.2.3.4	(Null)	Versione ma nessuna lingua.
1.2.3.4	0	La versione e la lingua sono neutrali.
Testdb	(Null)	File complementare senza lingua associata.
Testdb	1033	File e lingua complementare.
(Null)	1033	Nessuna versione, ma ha una lingua associata, ovvero typelib, helpfile.

 

Per altre informazioni, vedere la tabella MsiLockPermissionsEx Table e LockPermissions.

Convalida

ICE02
ICE03
ICE04
ICE06
ICE18
ICE30
ICE32
ICE35
ICE39
ICE42
ICE45
ICE50
ICE51
ICE54
ICE55
ICE57
ICE59
ICE60
ICE67
ICE69
ICE76
ICE91