/linkresource (collegamento a una risorsa di .NET Framework) (opzioni del compilatore C#)
Aggiornamento: novembre 2007
Crea un collegamento a una risorsa di .NET Framework nel file di output. Il file di risorse non viene aggiunto al file di output. Questa opzione è diversa dall'opzione /resource che incorpora un file di risorse nel file di output.
/linkresource:filename[,identifier[,accessibility-modifier]]
Argomenti
filename
Rappresenta il file di risorse .NET Framework cui si desidera stabilire un collegamento dall'assembly.identifier (facoltativo)
Nome logico della risorsa, utilizzato per caricare la risorsa stessa. L'impostazione predefinita corrisponde al nome del file.accessibility-modifier (facoltativo)
Rappresenta l'accessibilità della risorsa: public o private. L'impostazione predefinita è public.
Note
Per impostazione predefinita, le risorse collegate sono pubbliche nell'assembly quando vengono create con il compilatore C#. Per renderle private, specificare private come modificatore di accessibilità. Non è consentito alcun modificatore diverso da public o private.
Per /linkresource è necessaria un'opzione /target diversa da /target:module.
Se filename è un file di risorse .NET Framework creato, ad esempio, tramite Resgen.exe oppure nell'ambiente di sviluppo, sarà accessibile con i membri dello spazio dei nomi System.Resources. Per ulteriori informazioni, vedere System.Resources.ResourceManager. Per tutte le altre risorse, utilizzare i metodi GetManifestResource* nella classe Assembly per accedere alla risorsa in fase di esecuzione.
Il file specificato in filename può avere qualsiasi formato. È possibile ad esempio includere una DLL nativa nell'assembly, in modo da consentirne l'installazione nella Global Assembly Cache e l'accesso dal codice gestito nell'assembly. Nel secondo esempio riportato di seguito vengono illustrate le operazioni da eseguire a tal fine. È possibile eseguire la stessa operazione anche in Assembly Linker. Nel terzo esempio riportato di seguito vengono illustrate le operazioni da eseguire a tal fine. Per ulteriori informazioni, vedere Assembly Linker (Al.exe) e Utilizzo di assembly e della Global Assembly Cache.
/linkres rappresenta la forma abbreviata di /linkresource.
L'opzione del compilatore non è disponibile in Visual Studio e non può essere modificata a livello di codice.
Esempio
Compilare in.cs e creare un collegamento al file di risorse rf.resource.
csc /linkresource:rf.resource in.cs
Compilare A.cs in una DLL, creare un collegamento a una DLL N.dll nativa e inserire l'output nella Global Assembly Cache (GAC). In questo esempio i file A.dll e N.dll verranno memorizzati entrambi nella GAC.
csc /linkresource:N.dll /t:library A.cs
gacutil -i A.dll
In questo esempio viene eseguita la stessa operazione descritta in precedenza, ma vengono utilizzate le opzioni di Assembly Linker.
csc /t:module A.cs
al /out:A.dll A.netmodule /link:N.dll
gacutil -i A.dll