Attività AL (Assembly Linker)
L'attività AL esegue il wrapping di AL.exe, uno strumento distribuito con Windows Software Development Kit (SDK). Lo strumento Assembly Linker consente di creare un assembly con un manifesto da uno o più file che costituiscono moduli o file di risorse. Poiché è possibile che negli ambienti di compilazione e sviluppo queste funzionalità siano già disponibili, spesso non è necessario usare direttamente questa attività. Assembly Linker è particolarmente utile per gli sviluppatori che hanno la necessità di creare un unico assembly da più file di componenti, ad esempio quelli che possono essere prodotti dallo sviluppo in linguaggi misti. Questa attività non combina i moduli in un unico file assembly. Affinché l'assembly ottenuto venga caricato correttamente, è comunque necessario che i singoli moduli vengano distribuiti e che siano disponibili. Per altre informazioni su AL.exe, vedere Al.exe (Assembly Linker).
Parametri
Nella tabella che segue vengono descritti i parametri dell'attività AL.
| Parametro | Descrizione |
|---|---|
AlgorithmID |
Parametro String facoltativo.Specifica un algoritmo per generare un hash per tutti i file di un assembly su più file, ad eccezione del file contenente il manifesto dell'assembly. Per altre informazioni, vedere la documentazione relativa all'opzione /algid di Al.exe (Assembly Linker). |
BaseAddress |
Parametro String facoltativo.Specifica l'indirizzo in corrispondenza del quale caricare una DLL nel computer dell'utente in fase di esecuzione. Il caricamento delle applicazioni risulta più veloce se si specifica l'indirizzo di base delle DLL, anziché lasciare al sistema operativo il compito di rilocare le DLL nello spazio di processo. Questo parametro corrisponde all'opzione /baseaddress. |
CompanyName |
Parametro String facoltativo.Specifica una stringa per il campo Company dell'assembly. Per altre informazioni, vedere la documentazione relativa all'opzione /comp[any] di Al.exe (Assembly Linker). |
Configuration |
Parametro String facoltativo.Specifica una stringa per il campo Configuration dell'assembly. Per altre informazioni, vedere la documentazione relativa all'opzione /config[uration] di Al.exe (Assembly Linker). |
Copyright |
Parametro String facoltativo.Specifica una stringa per il campo Copyright dell'assembly. Per altre informazioni, vedere la documentazione relativa all'opzione /copy[right] di Al.exe (Assembly Linker). |
Culture |
Parametro String facoltativo.Specifica la stringa di impostazioni cultura da associare all'assembly. Per altre informazioni, vedere la documentazione relativa all'opzione /c[ulture] di Al.exe (Assembly Linker). |
DelaySign |
Parametro Boolean facoltativo.Se il parametro è impostato su true, nell'assembly viene inserita solo la chiave pubblica. Se è impostato su false, l'assembly viene firmato completamente. Per altre informazioni, vedere la documentazione relativa all'opzione /delay[sign] di Al.exe (Assembly Linker). |
Description |
Parametro String facoltativo.Specifica una stringa per il campo Description dell'assembly. Per altre informazioni, vedere la documentazione relativa all'opzione /descr[iption] di Al.exe (Assembly Linker). |
EmbedResources |
Parametro ITaskItem[] facoltativo.Incorpora le risorse specificate nell'immagine contenente il manifesto dell'assembly. Questa attività copia nell'immagine il contenuto del file di risorse. È possibile che agli elementi passati a questo parametro siano associati metadati facoltativi denominati LogicalName e Access. Il metadato LogicalName viene usato per specificare l'identificatore interno per la risorsa, mentre il metadato Access può essere impostato su private per rendere la risorsa invisibile ad altri assembly. Per altre informazioni, vedere la documentazione relativa all'opzione /embed[resource] di Al.exe (Assembly Linker). |
EvidenceFile |
Parametro String facoltativo.Incorpora il file specificato nell'assembly con il nome di risorsa Security.Evidence.Non è possibile usare il nome Security.Evidence per risorse regolari. Questo parametro corrisponde all'opzione /e[vidence] di Al.exe (Assembly Linker). |
ExitCode |
Parametro di sola lettura di output Int32 facoltativo.Specifica il codice di uscita fornito dal comando eseguito. |
FileVersion |
Parametro String facoltativo.Specifica una stringa per il campo File Version dell'assembly. Per altre informazioni, vedere la documentazione relativa all'opzione /fileversion di Al.exe (Assembly Linker). |
Flags |
Parametro String facoltativo.Specifica un valore per il campo Flags dell'assembly. Per altre informazioni, vedere la documentazione relativa all'opzione /flags di Al.exe (Assembly Linker). |
GenerateFullPaths |
Parametro Boolean facoltativo.Impone l'uso del percorso assoluto per tutti i file segnalati in un messaggio di errore. Questo parametro corrisponde all'opzione /fullpaths di Al.exe (Assembly Linker). |
KeyContainer |
Parametro String facoltativo.Specifica un contenitore che include una coppia di chiavi. Tale parametro firmerà l'assembly, ossia assegnerà a quest'ultimo un nome sicuro, inserendo una chiave pubblica nel manifesto dell'assembly. L'attività firmerà quindi l'assembly finale con la chiave privata. Per altre informazioni, vedere la documentazione relativa all'opzione /keyn[ame] di Al.exe (Assembly Linker). |
KeyFile |
Parametro String facoltativo.Specifica un file contenente una coppia di chiavi o solo una chiave pubblica da usare per la firma di un assembly. Durante la compilazione la chiave pubblica verrà inserita nel manifesto dell'assembly, mentre l'assembly finale verrà firmato con la chiave privata. Per altre informazioni, vedere la documentazione relativa all'opzione /keyf[ile] di Al.exe (Assembly Linker). |
LinkResources |
Parametro ITaskItem[] facoltativo.Collega i file di risorse specificati a un assembly. La risorsa specificata diventa parte dell'assembly, ma il file non viene copiato. È possibile che agli elementi passati a questo parametro siano associati metadati facoltativi denominati LogicalName, Target e Access. Il metadato LogicalName viene usato per specificare l'identificatore interno per la risorsa, mentre il metadato Target consente di specificare il percorso e il nome file in cui viene copiato il file prima che il nuovo file venga compilato nell'assembly. mentre il metadato Access può essere impostato su private per rendere la risorsa invisibile ad altri assembly. Per altre informazioni, vedere la documentazione relativa all'opzione /link[resource] di Al.exe (Assembly Linker). |
MainEntryPoint |
Parametro String facoltativo.Specifica il nome completo (classe.metodo) del metodo da usare come punto di ingresso durante la conversione di un modulo in un file eseguibile. Questo parametro corrisponde all'opzione /main di Al.exe (Assembly Linker). |
OutputAssembly |
Parametro di ouput ITaskItem facoltativo. Specifica il nome del file generato dall'attività. Questo parametro corrisponde all'opzione /out di Al.exe (Assembly Linker). |
Platform |
Parametro String facoltativo.Limita le piattaforme su cui è possibile eseguire il codice. I valori possibili sono x86, Itanium, x64 e anycpu. Il valore predefinito è anycpu. Questo parametro corrisponde all'opzione /platform di Al.exe (Assembly Linker). |
ProductName |
Parametro String facoltativo.Specifica una stringa per il campo Product dell'assembly. Per altre informazioni, vedere la documentazione relativa all'opzione /prod[uct] di Al.exe (Assembly Linker). |
ProductVersion |
Parametro String facoltativo.Specifica una stringa per il campo ProductVersion dell'assembly. Per altre informazioni, vedere la documentazione relativa all'opzione /productv[ersion] di Al.exe (Assembly Linker). |
ResponseFiles |
Parametro String[] facoltativo.Specifica i file di risposta contenenti opzioni aggiuntive da passare ad Assembly Linker. |
SdkToolsPath |
Parametro String facoltativo.Specifica il percorso degli strumenti SDK, ad esempio resgen.exe. |
SourceModules |
Parametro ITaskItem[] facoltativo.Corrisponde a uno o più moduli da compilare in un assembly. I moduli verranno elencati nel manifesto dell'assembly ottenuto. Affinché l'assembly venga caricato, è comunque necessario che i moduli vengano distribuiti e che siano disponibili. È possibile che agli elementi passati a questo parametro siano associati metadati aggiuntivi denominati Target, in cui sono specificati il percorso e il nome file in cui viene copiato il file prima che il nuovo file venga compilato nell'assembly. Per altre informazioni, vedere la documentazione relativa ad Al.exe (Assembly Linker). Questo parametro corrisponde all'elenco di moduli passati ad Al.exe senza un'opzione specifica. |
TargetType |
Parametro String facoltativo.Specifica il formato del file di output. I valori possibili sono: library per le librerie di codici, exe per le applicazioni console e win per le applicazioni basate su Windows. Il valore predefinito è library. Questo parametro corrisponde all'opzione /t[arget] di Al.exe (Assembly Linker). |
TemplateFile |
Parametro String facoltativo.Specifica l'assembly dal quale ereditare tutti i metadati dell'assembly, ad eccezione del campo relativo alle impostazioni cultura. All'assembly specificato deve essere assegnato un nome sicuro. Gli assembly creati con il parametro TemplateFile saranno assembly satellite. Questo parametro corrisponde all'opzione /template di Al.exe (Assembly Linker). |
Timeout |
Parametro Int32 facoltativo.Specifica la quantità di tempo, in millisecondi, dopo i quali l'eseguibile dell'attività viene terminato. Il valore predefinito è Int.MaxValue, con cui si indica che non esiste alcun periodo di timeout. |
Title |
Parametro String facoltativo.Specifica una stringa per il campo Title dell'assembly. Per altre informazioni, vedere la documentazione relativa all'opzione /title di Al.exe (Assembly Linker). |
ToolPath |
Parametro String facoltativo.Specifica la posizione da cui l'attività caricherà il file eseguibile sottostante (Al.exe). Se questo parametro non viene specificato, l'attività usa il percorso di installazione dell'SDK corrispondente alla versione del framework che esegue MSBuild. |
Trademark |
Parametro String facoltativo.Specifica una stringa per il campo Trademark dell'assembly. Per altre informazioni, vedere la documentazione relativa all'opzione /trade[mark] di Al.exe (Assembly Linker). |
Version |
Parametro String facoltativo.Specifica le informazioni sulla versione dell'assembly. Il formato della stringa è principale.secondario.build.revisione. Il valore predefinito è 0. Per altre informazioni, vedere la documentazione relativa all'opzione /v[ersion] di Al.exe (Assembly Linker). |
Win32Icon |
Parametro String facoltativo.Inserisce nell'assembly un file ICO. Il file ICO dà al file di output l'aspetto voluto in Esplora File. Questo parametro corrisponde all'opzione /win32icon di Al.exe (Assembly Linker). |
Win32Resource |
Parametro String facoltativo.Inserisce nel file di output una risorsa Win32 (file RES). Per altre informazioni, vedere la documentazione relativa all'opzione /win32res di Al.exe (Assembly Linker). |
Parametri ToolTaskExtension
Questa attività eredita dalla ToolTaskExtension classe , che eredita dalla ToolTask classe , che a sua volta eredita dalla Task classe . Questa catena di ereditarietà aggiunge diversi parametri alle attività che ne derivano.
Nella tabella seguente vengono descritti i parametri delle classi di base:
| Parametro | Descrizione |
|---|---|
| EchoOff | Parametro bool facoltativo.Se impostata su true, questa attività passa /Q alla riga di comando di cmd.exe in modo che la riga di comando non venga copiata in stdout. |
| EnvironmentVariables | Parametro di matrice String facoltativo.Matrice di definizioni di variabili di ambiente, separate da punti e virgola. Ogni definizione deve specificare un nome di variabile di ambiente e un valore separati da un segno di uguale. Queste variabili vengono passate all'eseguibile generato in aggiunta a o con override selettivo del blocco di ambiente standard. Ad esempio, Variable1=Value1;Variable2=Value2. |
| ExitCode | Parametro di sola lettura di output Int32 facoltativo.Specifica il codice di uscita fornito dal comando eseguito. Se l'attività ha registrato errori, ma il processo ha un codice di uscita pari a 0 (esito positivo), il parametro viene impostato su -1. |
| LogStandardErrorAsError | Parametro bool facoltativo.Se true, tutti i messaggi ricevuti nel flusso di errori standard vengono registrati come errori. |
| StandardErrorImportance | Parametro String facoltativo.Importanza con cui registrare il testo dal flusso di errore standard. |
| StandardOutputImportance | Parametro String facoltativo.Importanza con cui registrare il testo dal flusso di output standard. |
| Timeout | Parametro Int32 facoltativo.Specifica la quantità di tempo, in millisecondi, dopo i quali l'eseguibile dell'attività viene terminato. Il valore predefinito è Int.MaxValue, con cui si indica che non esiste alcun periodo di timeout. Il timeout è espresso in millisecondi. |
| ToolExe | Parametro string facoltativo.I progetti possono implementarlo per eseguire l'override di un ToolName. Le attività possono eseguirne l'override per conservare il ToolName. |
| ToolPath | Parametro string facoltativo.Specifica la posizione da cui l'attività carica il file eseguibile sottostante. Se questo parametro non viene specificato, l'attività usa il percorso di installazione dell'SDK corrispondente alla versione del framework che esegue MSBuild. |
| UseCommandProcessor | Parametro bool facoltativo.Se true, questa attività crea un file batch per la riga di comando e lo esegue mediante il processore dei comandi anziché eseguire direttamente il comando. |
| YieldDuringToolExecution | Parametro bool facoltativo.Se true, questa attività restituisce il nodo quando l'attività è in esecuzione. |
Esempio
Nell'esempio seguente viene creato un assembly con le opzioni specificate.
<AL
EmbedResources="@(EmbeddedResource)"
Culture="%(EmbeddedResource.Culture)"
TemplateFile="@(IntermediateAssembly)"
KeyContainer="$(KeyContainerName)"
KeyFile="$(KeyOriginatorFile)"
DelaySign="$(DelaySign)"
OutputAssembly=
"%(EmbeddedResource.Culture)\$(TargetName).resources.dll">
<Output TaskParameter="OutputAssembly"
ItemName="SatelliteAssemblies"/>
</AL>