AL (Assembly Linker) — Zadanie
Zadania AL otacza AL.exe narzędzie jest rozpowszechniane z Windows Software Development Kit (SDK).To narzędzie Assembly Linker służy do tworzenia zestawu z manifestu z jednego lub więcej plików, które są albo modułów lub plików zasobów.Kompilatory i środowiskach programistycznych program może być już udostępniają te możliwości tak często nie jest konieczne użycie tego zadania bezpośrednio.Assembly Linker jest najbardziej przydatne deweloperom konieczności tworzenia jednego zestawu z wielu plików składników, takich jak te, które może być wyprodukowane z mieszanego języka programowania.To zadanie nie łączyć modułów w pliku pojedynczego zestawu; poszczególnych modułów musi być dystrybuowane i dostępne w celu zgromadzenia wynikowy poprawnie załadować.Aby uzyskać więcej informacji na AL.exe zobacz Al.exe (Konsolidator zestawów).
Parametry
W poniższej tabeli opisano parametry AL zadania.
Parametr |
Opis |
|---|---|
AlgorithmID |
Opcjonalny String parametru. Określa algorytm mieszania wszystkie pliki w zestawie multifile z wyjątkiem pliku zawierającego manifestu zestawu.Aby uzyskać więcej informacji, zobacz dokumentację /algid opcji w Al.exe (Konsolidator zestawów). |
BaseAddress |
Opcjonalny String parametru. Określa adres, na którym zostanie załadowana biblioteka DLL na komputerze użytkownika w czasie wykonywania.Aplikacje ładowały się szybciej, jeśli określony adres bazowy biblioteki DLL, zamiast najmu systemu operacyjnego przemieścić biblioteki DLL w przestrzeni procesu.Ten parametr odnosi się do opcji [adres] /base w Al.exe (Konsolidator zestawów). |
CompanyName |
Opcjonalny String parametru. Określa ciąg dla Company pól w zestawie.Aby uzyskać więcej informacji, zobacz dokumentację /comp[any] opcji w Al.exe (Konsolidator zestawów). |
Configuration |
Opcjonalny String parametru. Określa ciąg dla Configuration pól w zestawie.Aby uzyskać więcej informacji, zobacz dokumentację /config[uration] opcji w Al.exe (Konsolidator zestawów). |
Copyright |
Opcjonalny String parametru. Określa ciąg dla Copyright pól w zestawie.Aby uzyskać więcej informacji, zobacz dokumentację /copy[right] opcji w Al.exe (Konsolidator zestawów). |
Culture |
Opcjonalny String parametru. Określa ciąg kultury, aby skojarzyć z zestawu.Aby uzyskać więcej informacji, zobacz dokumentację /c[ulture] opcji w Al.exe (Konsolidator zestawów). |
DelaySign |
Opcjonalny Boolean parametru. trueAby umieścić tylko klucz publiczny w zestawie; falsepełni podpisać zestawu.Aby uzyskać więcej informacji, zobacz dokumentację /delay[sign] opcji w Al.exe (Konsolidator zestawów). |
Description |
Opcjonalny String parametru. Określa ciąg dla Description pól w zestawie.Aby uzyskać więcej informacji, zobacz dokumentację /descr[iption] opcji w Al.exe (Konsolidator zestawów). |
EmbedResources |
Opcjonalny ITaskItem[] parametru. Osadza określonych zasobów w obraz, który zawiera manifestu zestawu.To zadanie kopiuje zawartość pliku zasobów do obrazu.Elementy przekazywane ten parametr może mieć opcjonalne metadanych dołączone do nich o nazwie LogicalName i Access.LogicalName Metadanych jest używana do określenia wewnętrzny identyfikator zasobu.Access Metadanych można ustawić na private , aby zasób nie jest widoczny dla innych zestawów.Aby uzyskać więcej informacji, zobacz dokumentację /embed[resource] opcji w Al.exe (Konsolidator zestawów). |
EvidenceFile |
Opcjonalny String parametru. Osadza określony plik w zestawie z nazwą zasobu Security.Evidence. Nie można użyć Security.Evidence dla regularnych zasobów.Ten parametr odnosi się do /e[vidence] opcji w Al.exe (Konsolidator zestawów). |
ExitCode |
Opcjonalny Int32 tylko do odczytu parametr wyjścia. Określa kod wyjścia, świadczone przez wykonane polecenie. |
FileVersion |
Opcjonalny String parametru. Określa ciąg dla File Version pól w zestawie.Aby uzyskać więcej informacji, zobacz dokumentację /fileversion opcji w Al.exe (Konsolidator zestawów). |
Flags |
Opcjonalny String parametru. Określa wartość dla Flags pól w zestawie.Aby uzyskać więcej informacji, zobacz dokumentację /flags opcji w Al.exe (Konsolidator zestawów). |
GenerateFullPaths |
Opcjonalny Boolean parametru. Powoduje zadania za pomocą ścieżki bezwzględnej dla plików są raportowane komunikat o błędzie.Ten parametr odnosi się do /fullpaths opcji w Al.exe (Konsolidator zestawów). |
KeyContainer |
Opcjonalny String parametru. Określa kontener, który posiada parę kluczy.To będzie podpisywać zestawu (nadaj silnej nazwy), wstawiając klucza publicznego do manifestu zestawu.Zadanie będzie następnie podpisywać montażu końcowego przy użyciu klucza prywatnego.Aby uzyskać więcej informacji, zobacz dokumentację /keyn[ame] opcji w Al.exe (Konsolidator zestawów). |
KeyFile |
Opcjonalny String parametru. Określa plik, który zawiera pary kluczy lub kluczem publicznym do podpisywania zestawu.Kompilator wstawia manifestu zestawu klucz publiczny i następnie podpisuje montażu końcowego przy użyciu klucza prywatnego.Aby uzyskać więcej informacji, zobacz dokumentację /keyf[ile] opcji w Al.exe (Konsolidator zestawów). |
LinkResources |
Opcjonalny ITaskItem[] parametru. Łączy pliki zasobów określonego zestawu.Zasób staje się częścią zestawu, ale plik nie jest kopiowany.Elementy przekazywane ten parametr może mieć opcjonalne metadanych dołączone do nich o nazwie LogicalName, Target, i Access.LogicalName Metadanych jest używana do określenia wewnętrzny identyfikator zasobu.Target Metadanych można określić ścieżkę i nazwę pliku, do którego zadanie kopiuje plik, po którym kompiluje ten nowy plik do zestawu.Access Metadanych można ustawić na private , aby zasób nie jest widoczny dla innych zestawów.Aby uzyskać więcej informacji, zobacz dokumentację /link[resource] opcji w Al.exe (Konsolidator zestawów). |
MainEntryPoint |
Opcjonalny String parametru. Określa w pełni kwalifikowaną nazwę (class.method) metody używany jako punkt wejścia podczas konwertowania moduł do pliku wykonywalnego.Ten parametr odnosi się do /main opcji w Al.exe (Konsolidator zestawów). |
OutputAssembly |
Wymagane ITaskItem parametr wyjścia. Określa nazwę pliku generowanych przez to zadanie.Ten parametr odnosi się do /out opcji w Al.exe (Konsolidator zestawów). |
Platform |
Opcjonalny String parametru. Ogranicza platformy, które można uruchamiać ten kod must be one of x86, Itanium, x64, or anycpu.Wartością domyślną jest anycpu.Ten parametr odnosi się do /platform opcji w Al.exe (Konsolidator zestawów). |
ProductName |
Opcjonalny String parametru. Określa ciąg dla Product pól w zestawie.Aby uzyskać więcej informacji, zobacz dokumentację /prod[uct] opcji w Al.exe (Konsolidator zestawów). |
ProductVersion |
Opcjonalny String parametru. Określa ciąg dla ProductVersion pól w zestawie.Aby uzyskać więcej informacji, zobacz dokumentację /productv[ersion] opcji w Al.exe (Konsolidator zestawów). |
ResponseFiles |
Opcjonalny String[] parametru. Określa pliki odpowiedzi, które zawierają dodatkowe opcje przejść do Assembly Linker. |
SdkToolsPath |
Opcjonalny String parametru. Określa ścieżkę do narzędzi zestawu SDK, takich jak resgen.exe. |
SourceModules |
Opcjonalny ITaskItem[] parametru. Jeden lub więcej modułów zestawiane w zespół.Moduły zostaną wymienione w manifeście wynikowego zestawu i nadal będzie musiał dystrybuowane i dostępne w celu zgromadzenia załadować.Elementy do tego parametru może mieć dodatkowe metadane o nazwie Target, który określa ścieżkę i nazwę pliku, do którego zadanie kopiuje plik, po którym kompiluje ten nowy plik do zestawu.Aby uzyskać więcej informacji, zobacz dokumentację Al.exe (Konsolidator zestawów).Parametr ten odpowiada listę modułów przekazywanych do Al.exe bez szczególnych przełącznika. |
TargetType |
Opcjonalny String parametru. Określa format pliku wyjściowego: library (kod biblioteki), exe (konsoli aplikacji), lub win (aplikacji opartych na systemie Windows).Wartością domyślną jest library.Ten parametr odnosi się do /t[arget] opcji w Al.exe (Konsolidator zestawów). |
TemplateFile |
Opcjonalny String parametru. Określa zgromadzenie, z której dziedziczy wszystkie metadane zgromadzenie, oprócz pola kultury.Określony zestaw musi mieć silnej nazwy. Tworzenie z zestawu TemplateFile parametr będzie zestawu satelickiego.Ten parametr odnosi się do /template opcji w Al.exe (Konsolidator zestawów). |
Timeout |
Opcjonalny Int32 parametru. Określa czas, w milisekundach, po których wykonywalny zadanie jest zakończone.Wartością domyślną jest Int.MaxValue, wskazująca, że jest nie okresu czasu. |
Title |
Opcjonalny String parametru. Określa ciąg dla Title pól w zestawie.Aby uzyskać więcej informacji, zobacz dokumentację /title opcji w Al.exe (Konsolidator zestawów). |
ToolPath |
Opcjonalny String parametru. Określa lokalizację, z którym zadanie załaduje podstawowego pliku wykonywalnego (Al.exe).Jeżeli nie określono tego parametru, zadanie używa ścieżki instalacji zestawu SDK odpowiadającej wersji ramy, w którym działa MSBuild. |
Trademark |
Opcjonalny String parametru. Określa ciąg dla Trademark pól w zestawie.Aby uzyskać więcej informacji, zobacz dokumentację /trade[mark] opcji w Al.exe (Konsolidator zestawów). |
Version |
Opcjonalny String parametru. Określa informacje o wersji dla tego zestawu.Format ciągu jest major.minor.build.revision.Wartością domyślną jest 0.Aby uzyskać więcej informacji, zobacz dokumentację /v[ersion] opcji w Al.exe (Konsolidator zestawów). |
Win32Icon |
Opcjonalny String parametru. Wstawia plik .ico w zestawie.Plik .ico daje pliku wyjściowego żądanego wyglądu w Eksploratorze pliku.Ten parametr odnosi się do /win32icon opcji w Al.exe (Konsolidator zestawów). |
Win32Resource |
Opcjonalny String parametru. Wstawia zasobów Win32 (.res pliku) pliku wyjściowego.Aby uzyskać więcej informacji, zobacz dokumentację /win32res opcji w Al.exe (Konsolidator zestawów). |
Uwagi
Oprócz parametrów wymienionych powyżej, to zadanie dziedziczy parametry z ToolTaskExtension , które sama klasa dziedziczy z ToolTask klasy.Listy te dodatkowe parametry i ich opisy, zobacz ToolTaskExtension — Klasa podstawowa.
Przykład
Poniższy przykład tworzy zespół z określonych opcji.
<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>