Proprietà dei file

Articolo
08/11/2011

Le proprietà dei file consentono di definire le operazioni da eseguire sui file stessi dal sistema del progetto. È possibile, ad esempio, impostare le proprietà dei file per indicare se un file deve essere compilato o incorporato come risorsa nell'output di compilazione.

È possibile selezionare qualsiasi file in Esplora soluzioni ed esaminarne le proprietà nella finestra Proprietà. Per i file di Visual Basic e Visual C# sono disponibili quattro proprietà: Nome file, Operazione di compilazione, Strumento personalizzato e Spazio dei nomi dello strumento personalizzato.

Nota

Le proprietà Operazione di compilazione, Strumento personalizzato e Spazio dei nomi dello strumento personalizzato vengono fornite per scenari avanzati. I valori predefiniti sono in genere sufficienti e non richiedono alcuna modifica.

Proprietà Nome file

Per rinominare un file, è possibile fare clic sulla proprietà Nome file nella finestra Proprietà e quindi digitare il nuovo nome. Se si modifica il nome del file, in Visual Studio qualsiasi file VB o RESX associato a esso verrà automaticamente rinominato.

Proprietà Operazione di compilazione

La proprietà Operazione di compilazione indica l'operazione eseguita in Visual Studio in un file durante la compilazione. Alla proprietà Operazione di compilazione possono essere assegnati diversi valori:

None: il file non è incluso nel gruppo di output del progetto e non viene compilato nel processo di compilazione. Un file di questo tipo può essere un file di testo contenente informazioni varie, ad esempio un file Readme.
Compile: il file viene compilato nell'output di compilazione; impostazione utilizzata per i file di codice.
Content: il file non viene compilato, ma è incluso nel gruppo di output denominato Contenuto. L'impostazione rappresenta ad esempio il valore predefinito per un file HTM o altro tipo di file Web.
Embedded Resource - Il file viene incorporato nell'output di compilazione del progetto principale come file DLL o file eseguibile; impostazione normalmente utilizzata per il file di risorse.

Nota

La proprietà Operazione di compilazione è estensibile. Di conseguenza, è possibile che per la proprietà vengano elencate altre opzioni, aggiunte da altri prodotti e funzionalità.

Il valore predefinito di Operazione di compilazione dipende dall'estensione del file aggiunto alla soluzione. Se, ad esempio, si aggiunge un progetto di Visual Basic a Esplora soluzioni, il valore predefinito per Operazione di compilazione sarà Compilazione. Perché l'estensione .vb indica un file di codice che può essere compilato. I nomi e le estensioni dei file vengono visualizzati in Esplora soluzioni.

Il nome del file nel progetto non rappresenta l'identificatore della risorsa gestita nel manifesto assembly; per ulteriori informazioni, vedere Manifesto assembly. L'identificatore sarà spazionomi.nomefile.estensione, dove spazionomi è il valore della proprietà DefaultNamespace in un progetto Visual C# o della proprietà RootNamespace in un progetto Visual Basic. Filename e extension rimangono invariati rispetto alla designazione originale. Se il file ha estensione RESX, il sistema di progetto eseguirà resgen.exe sul file, creando un file RESOURCE. Il file .resource sarà incorporato nell'assembly. Di conseguenza, il manifesto dell'assembly farà riferimento al file .resources e non al file .resx.

Se si aggiunge ad esempio il file File.bmp a un progetto il cui spazio dei nomi predefinito è Prog e si imposta l'operazione di compilazione su Embedded Resource, Prog.File.bmp rappresenterà l'identificatore nel manifesto assembly. Se si aggiunge il file File.resx al progetto, l'operazione di compilazione predefinita sarà Embedded Resource e Prog.File.resources rappresenterà l'identificatore nel manifesto assembly.

Notare che quando nell'editor risorse viene aggiunta un'immagine, la proprietà BuildAction viene impostata su None, poiché il file RESX fa riferimento al file di immagine. Durante la compilazione, l'immagine verrà inserita nel file RESOURCES creato dal file RESX. Sarà quindi possibile accedere agevolmente all'immagine tramite la classe fortemente tipizzata generata automaticamente per il file RESX. Non è pertanto consigliabile modificare questa impostazione in Embedded Resource, poiché l'immagine verrebbe inclusa due volte nell'assembly.

Per ulteriori informazioni sull'accesso ai file di risorse (compilati da file RESX) in fase di esecuzione, vedere ResourceManager. Per ulteriori informazioni sull'accesso ad altre risorse e file incorporati in fase di esecuzione, vedere GetManifestResourceStream.

Proprietà Copia nella directory di output

Questa proprietà consente di specificare le condizioni in cui il file di origine selezionato verrà copiato nella directory di output. Selezionare Non copiare se il file non viene mai copiato nella directory di output. Selezionare Copia sempre se il file viene sempre copiato nella directory di output. Selezionare Copia se più recente se il file deve essere copiato solo quando è più recente del file esistente con lo stesso nome nella directory di output.

Per informazioni sulla modifica della directory di output, vedere Pagina Compilazione, Progettazione progetti (C#) o Pagina Compilazione, Progettazione progetti (Visual Basic).

Nota

Nei progetti Smart Device, viene determinato quale file DLL o EXE sia più recente confrontando le due versioni Win32 nel modo seguente:

Se la versione sul dispositivo è precedente a quella del desktop, il file viene copiato.

Se la versione sul dispositivo è successiva a quella del desktop, il file non viene copiato.

Se le due versioni sono uguali, viene eseguito un confronto dei checksum. Se i checksum sono uguali, il file non viene copiato. Se i checksum sono diversi, il file viene copiato.

Per i file non DLL o EXE, il file più recente viene determinato esclusivamente in base al checksum.

Nota

I file di dati verranno copiati in una sottocartella denominata File di dati nella directory di output.

Proprietà Strumento personalizzato

Gli strumenti personalizzati sono componenti utilizzabili per convertire file da un tipo a un altro in fase di progettazione. Può trattarsi ad esempio di un generatore di codice DataSet, che legge un file XML Schema XSD e genera delle classi in un file di codice che espone, a livello di programmazione, le relative tabelle e colonne. Esiste un elenco predefinito di strumenti personalizzati disponibili nel prodotto; questa proprietà consente di determinare quale strumento personalizzato è applicato a un file. In rari casi, potrebbe essere necessario modificare il valore di questa proprietà, che deve essere vuoto oppure corrispondere a uno degli strumenti personalizzati incorporati.

Per impostare o modificare lo strumento personalizzato, fare clic sulla proprietà CustomTool nella finestra Proprietà e digitare il nome di uno strumento personalizzato.

Spazio dei nomi dello strumento personalizzato

Se al progetto è assegnato uno strumento personalizzato, la proprietà Spazio dei nomi dello strumento personalizzato consente di specificare lo spazio dei nomi da assegnare al codice generato dallo strumento personalizzato. Quando si specifica un valore per la proprietà Spazio dei nomi dello strumento personalizzato, il codice generato dallo strumento viene inserito nello spazio dei nomi specificato. Se la proprietà è vuota, il codice generato viene collocato nello spazio dei nomi predefinito per la cartella nella quale si trova il file convertito. Per Visual Basic, si tratta dello spazio dei nomi radice del progetto, mentre in Visual C# corrisponde all'impostazione della proprietà DefaultNamespace della cartella.