AL (Assembly Linker) zadania
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 Program al.exe (Assembly Linker).
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
Culture |
Opcjonalny String parametru. Określa ciąg kultury, aby skojarzyć z zestawu.Aby uzyskać więcej informacji, zobacz dokumentację /c[ulture] opcji w Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
Flags |
Opcjonalny String parametru. Określa wartość dla Flags pól w zestawie.Aby uzyskać więcej informacji, zobacz dokumentację /flags opcji w Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
OutputAssembly |
Wymagane ITaskItem parametr wyjścia. Określa nazwę pliku generowanych przez to zadanie.Ten parametr odnosi się do /out opcji w Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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ę Program al.exe (Assembly Linker).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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
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 Program al.exe (Assembly Linker). |
Win32Resource |
Opcjonalny String parametru. Wstawia zasobów Win32 (.res pliku) pliku wyjściowego.Aby uzyskać więcej informacji, zobacz dokumentację /win32res opcji w Program al.exe (Assembly Linker). |
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 Klasa bazowa ToolTaskExtension.
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>