Risorse in formato di file di testo

I file di testo (TXT) possono contenere solo risorse di tipo stringa. Se si salva correttamente un file di testo, è possibile specificare le stringhe utilizzando uno dei tre schemi di codifica: UTF-16, nell'ordine di byte little-endian o big-endian, oppure UTF-8. Se, ad esempio, si desidera salvare e utilizzare i caratteri della lingua tedesca, è necessario salvare il file di testo utilizzando la codifica UTF-8 anziché una tabella codici ANSI specifica. Per ulteriori informazioni sull'utilizzo delle codifiche, vedere Unicode in .NET Framework.

Nota

Per impostazione predefinita, lo strumento generatore di file di risorse (Resgen.exe) considera i file in formato UTF-8. Perché Resgen.exe consenta di riconoscere un file codificato con UTF-16, è necessario includere all'inizio del file un contrassegno dell'ordine di byte Unicode (U+FEFF).

Oltre alle stringhe, i file di testo possono contenere commenti. Non esiste un limite al numero di voci che è possibile includere nei file di testo. È anche possibile inserire nel file righe vuote per semplificarne la lettura. Gli spazi che precedono e seguono una riga non vengono inclusi quando la riga viene archiviata o recuperata. È inoltre possibile utilizzare una stringa vuota.

Se il file di testo contiene nomi di risorsa duplicati, lo strumento Resgen.exe genera un avviso e ignora i nomi duplicati.

Nella seguente tabella vengono descritti i tipi di voci ammessi per i file di testo.

Voce	Descrizione
;commenti	È possibile includere commenti all'interno di un file di testo. Il commento deve essere preceduto da un punto e virgola oppure dal simbolo del cancelletto (#). I commenti possono essere utili per illustrare l'organizzazione delle risorse. È ad esempio possibile organizzare le risorse contenute in un particolare file etichettandole con commenti come ;eccezioni, ;messaggi generici, ;etichette di testo, ;titoli di moduli e così via. Quando un file TXT viene convertito in un file RESOURCES, i commenti vanno perduti.
nome = valore	Le risorse di tipo stringa vanno specificate come coppie nome/valore, in cui il nome è una stringa che descrive la risorsa e il valore è la stringa di risorsa che verrà restituita quando si recupera il nome tramite il metodo ResourceManager.GetString. Il nome e il valore devono essere separati da un segno di uguale (=), ad esempio Msg1 = Salve a tutti. Il valore non può contenere caratteri di nuova riga, tuttavia è possibile utilizzare caratteri di escape di tipo C, quali \n per rappresentare una nuova riga e \t per rappresentare una tabulazione. È inoltre possibile utilizzare una stringa vuota, ad esempio MyEmptyString=.

Una volta aggiunte tutte le voci desiderate al file di testo, salvarlo con un nome appropriato e aggiungervi l'estensione TXT.

Nota

Non utilizzare file di risorse per archiviare password, informazioni riservate o dati personali.

Non è possibile incorporare un file TXT in un assembly. Per effettuare questa operazione, è necessario convertire il file TXT in un file RESOURCES utilizzando lo strumento generatore di file di risorse (Resgen.exe). Per ulteriori informazioni, vedere Risorse in formato di file RESOURCES.

Vedere anche

Riferimenti

Generatore di file di risorse (Resgen.exe)

Concetti

Creazione di file di risorse
Risorse in formato di file RESOURCES