AL (Assembly Linker), zadanie

Zadanie AL opakowuje AL.exe — narzędzie dystrybuowane za pomocą zestawu Windows Software Development Kit (SDK). To narzędzie konsolidatora zestawów służy do tworzenia zestawu z manifestem z co najmniej jednego pliku, które są modułami lub plikami zasobów. Kompilatory i środowiska programistyczne mogą już udostępniać te możliwości, dlatego często nie jest konieczne bezpośrednie użycie tego zadania. Konsolidator zestawów jest najbardziej przydatny dla deweloperów, którzy muszą utworzyć pojedynczy zestaw z wielu plików składników, takich jak te, które mogą być tworzone z programowania w języku mieszanym. To zadanie nie łączy modułów w jeden plik zestawu; Poszczególne moduły muszą być nadal dystrybuowane i dostępne w celu poprawnego załadowania wynikowego zestawu. Aby uzyskać więcej informacji na temat AL.exe, zobacz Al.exe (Assembly Linker).

Parametry

W poniższej tabeli opisano parametry AL zadania.

Parametr	Opis
AlgorithmID	Opcjonalny String parametr. Określa algorytm wyznaczania wartości skrótu dla wszystkich plików w wieloplikowym zestawie z wyjątkiem pliku, który zawiera manifest zestawu. Aby uzyskać więcej informacji, zobacz dokumentację /algid dotyczącą opcji w al.exe (Assembly Linker).
BaseAddress	Opcjonalny String parametr. Określa adres, pod którym zostanie załadowana biblioteka DLL na komputerze użytkownika w czasie wykonywania. Aplikacje ładują się szybciej, jeśli określisz podstawowy adres bibliotek DLL, zamiast zezwalać systemowi operacyjnemu na przeniesienie bibliotek DLL w przestrzeni procesowej. Ten parametr odpowiada /baseaddress.
CompanyName	Opcjonalny String parametr. Określa ciąg dla Company pola w zestawie. Aby uzyskać więcej informacji, zobacz dokumentację /comp[any] dotyczącą opcji w al.exe (Assembly Linker).
Configuration	Opcjonalny String parametr. Określa ciąg dla Configuration pola w zestawie. Aby uzyskać więcej informacji, zobacz dokumentację /config[uration] dotyczącą opcji w al.exe (Assembly Linker).
Copyright	Opcjonalny String parametr. Określa ciąg dla Copyright pola w zestawie. Aby uzyskać więcej informacji, zobacz dokumentację /copy[right] dotyczącą opcji w al.exe (Assembly Linker).
Culture	Opcjonalny String parametr. Określa ciąg kultury do skojarzenia z zestawem. Aby uzyskać więcej informacji, zobacz dokumentację /c[ulture] dotyczącą opcji w al.exe (Assembly Linker).
DelaySign	Opcjonalny Boolean parametr. true umieścić tylko klucz publiczny w zestawie; false w celu pełnego podpisania zestawu. Aby uzyskać więcej informacji, zobacz dokumentację /delay[sign] dotyczącą opcji w al.exe (Assembly Linker).
Description	Opcjonalny String parametr. Określa ciąg dla Description pola w zestawie. Aby uzyskać więcej informacji, zobacz dokumentację /descr[iption] dotyczącą opcji w al.exe (Assembly Linker).
EmbedResources	Opcjonalny ITaskItem[] parametr. Osadza określone zasoby na obrazie zawierającym manifest zestawu. To zadanie kopiuje zawartość pliku zasobu do obrazu. Elementy przekazane do tego parametru mogą mieć dołączone opcjonalne metadane o nazwie LogicalName i Access. Metadane LogicalName służą do określania identyfikatora wewnętrznego zasobu. Metadane Access można ustawić na private , aby zasób nie był widoczny dla innych zestawów. Aby uzyskać więcej informacji, zobacz dokumentację /embed[resource] dotyczącą opcji w al.exe (Assembly Linker).
EvidenceFile	Opcjonalny String parametr. Osadza określony plik w zestawie z nazwą Security.Evidencezasobu . Nie można używać Security.Evidence dla zwykłych zasobów. Ten parametr odpowiada /e[vidence] opcji w Al.exe (Assembly Linker).
ExitCode	Opcjonalny Int32 parametr tylko do odczytu. Określa kod zakończenia dostarczony przez wykonane polecenie.
FileVersion	Opcjonalny String parametr. Określa ciąg dla File Version pola w zestawie. Aby uzyskać więcej informacji, zobacz dokumentację /fileversion dotyczącą opcji w al.exe (Assembly Linker).
Flags	Opcjonalny String parametr. Określa wartość Flags pola w zestawie. Aby uzyskać więcej informacji, zobacz dokumentację /flags dotyczącą opcji w al.exe (Assembly Linker).
GenerateFullPaths	Opcjonalny Boolean parametr. Powoduje, że zadanie używa ścieżki bezwzględnej dla wszystkich plików zgłaszanych w komunikacie o błędzie. Ten parametr odpowiada /fullpaths opcji w Al.exe (Assembly Linker).
KeyContainer	Opcjonalny String parametr. Określa kontener zawierający parę kluczy. Zestaw zostanie podpisany (należy nadać mu silną nazwę) przez wstawienie klucza publicznego do manifestu zestawu. Następnie zadanie podpisze ostateczny zestaw kluczem prywatnym. Aby uzyskać więcej informacji, zobacz dokumentację /keyn[ame] dotyczącą opcji w al.exe (Assembly Linker).
KeyFile	Opcjonalny String parametr. Określa plik, który zawiera parę kluczy lub tylko klucz publiczny do podpisania zestawu. Kompilator wstawia klucz publiczny w manifeście zestawu, a następnie podpisuje ostateczny zestaw przy użyciu klucza prywatnego. Aby uzyskać więcej informacji, zobacz dokumentację /keyf[ile] dotyczącą opcji w al.exe (Assembly Linker).
LinkResources	Opcjonalny ITaskItem[] parametr. Łączy określone pliki zasobów z zestawem. Zasób staje się częścią zestawu, ale plik nie jest kopiowany. Elementy przekazane do tego parametru mogą mieć dołączone opcjonalne metadane o nazwie LogicalName, Targeti Access. Metadane LogicalName służą do określania identyfikatora wewnętrznego zasobu. Metadane Target mogą określać ścieżkę i nazwę pliku, do którego zadanie kopiuje plik, po czym skompiluje ten nowy plik do zestawu. Metadane Access można ustawić na private , aby zasób nie był widoczny dla innych zestawów. Aby uzyskać więcej informacji, zobacz dokumentację /link[resource] dotyczącą opcji w al.exe (Assembly Linker).
MainEntryPoint	Opcjonalny String parametr. Określa w pełni kwalifikowaną nazwę (class.method) metody, która ma być używana jako punkt wejścia podczas konwertowania modułu na plik wykonywalny. Ten parametr odpowiada /main opcji w Al.exe (Assembly Linker).
OutputAssembly	Wymagany ITaskItem parametr wyjściowy. Określa nazwę pliku wygenerowanego przez to zadanie. Ten parametr odpowiada /out opcji w Al.exe (Assembly Linker).
Platform	Opcjonalny String parametr. Ogranicza platformę, na której można uruchomić ten kod; musi być jednym z x86elementów , Itanium, x64lub anycpu. Wartość domyślna to anycpu. Ten parametr odpowiada /platform opcji w Al.exe (Assembly Linker).
ProductName	Opcjonalny String parametr. Określa ciąg dla Product pola w zestawie. Aby uzyskać więcej informacji, zobacz dokumentację /prod[uct] dotyczącą opcji w al.exe (Assembly Linker).
ProductVersion	Opcjonalny String parametr. Określa ciąg dla ProductVersion pola w zestawie. Aby uzyskać więcej informacji, zobacz dokumentację /productv[ersion] dotyczącą opcji w al.exe (Assembly Linker).
ResponseFiles	Opcjonalny String[] parametr. Określa pliki odpowiedzi zawierające dodatkowe opcje, które mają być przekazywane do konsolidatora zestawów.
SdkToolsPath	Opcjonalny String parametr. Określa ścieżkę do narzędzi zestawu SDK, takich jak resgen.exe.
SourceModules	Opcjonalny ITaskItem[] parametr. Co najmniej jeden moduł do skompilowania w zestawie. Moduły zostaną wyświetlone w manifeście wynikowego zestawu i nadal będą musiały być dystrybuowane i dostępne w celu załadowania zestawu. Elementy przekazane do tego parametru mogą mieć dodatkowe metadane o nazwie Target, które określają ścieżkę i nazwę pliku, do którego zadanie kopiuje plik, po czym skompiluje ten nowy plik do zestawu. Aby uzyskać więcej informacji, zobacz dokumentację narzędzia Al.exe (Assembly Linker). Ten parametr odpowiada liście modułów przekazanych do pliku Al.exe bez określonego przełącznika.
TargetType	Opcjonalny String parametr. Określa format pliku wyjściowego: library (biblioteka kodu), exe (aplikacja konsolowa) lub win (aplikacja oparta na systemie Windows). Wartość domyślna to library. Ten parametr odpowiada /t[arget] opcji w Al.exe (Assembly Linker).
TemplateFile	Opcjonalny String parametr. Określa zestaw, z którego mają dziedziczyć wszystkie metadane zestawu, z wyjątkiem pola kultury. Określony zestaw musi mieć silną nazwę. Zestaw utworzony za pomocą parametru TemplateFile będzie zestawem satelitarnym. Ten parametr odpowiada /template opcji w Al.exe (Assembly Linker).
Timeout	Opcjonalny Int32 parametr. Określa czas w milisekundach, po którym plik wykonywalny zadania zostanie zakończony. Wartość domyślna to Int.MaxValue, co oznacza, że nie ma limitu czasu.
Title	Opcjonalny String parametr. Określa ciąg dla Title pola w zestawie. Aby uzyskać więcej informacji, zobacz dokumentację /title dotyczącą opcji w al.exe (Assembly Linker).
ToolPath	Opcjonalny String parametr. Określa lokalizację, z której zadanie załaduje źródłowy plik wykonywalny (Al.exe). Jeśli ten parametr nie zostanie określony, zadanie używa ścieżki instalacyjnej zestawu SDK odpowiadającej wersji platformy z uruchomionym programem MSBuild.
Trademark	Opcjonalny String parametr. Określa ciąg dla Trademark pola w zestawie. Aby uzyskać więcej informacji, zobacz dokumentację /trade[mark] dotyczącą opcji w al.exe (Assembly Linker).
Version	Opcjonalny String parametr. Określa informacje o wersji dla tego zestawu. Format ciągu to major.minor.build.revision. Wartość domyślna to 0. Aby uzyskać więcej informacji, zobacz dokumentację /v[ersion] dotyczącą opcji w al.exe (Assembly Linker).
Win32Icon	Opcjonalny String parametr. Wstawia plik ico do zestawu. Plik ico daje plik wyjściowy żądany wygląd w Eksplorator plików. Ten parametr odpowiada /win32icon opcji w Al.exe (Assembly Linker).
Win32Resource	Opcjonalny String parametr. Wstawia zasób Win32 (plik res ) w pliku wyjściowym. Aby uzyskać więcej informacji, zobacz dokumentację /win32res dotyczącą opcji w al.exe (Assembly Linker).

Parametry toolTaskExtension

To zadanie dziedziczy z ToolTaskExtension klasy dziedziczonej ToolTask po klasie, która dziedziczy się po Task klasie. Ten łańcuch dziedziczenia dodaje kilka parametrów do zadań, które pochodzą z nich.

W poniższej tabeli opisano parametry klas bazowych:

Parametr	Opis
EchoOff	Opcjonalny bool parametr. Gdy jest ustawiona wartość true, to zadanie przekazuje /Q do wiersza polecenia cmd.exe , tak aby wiersz polecenia nie został skopiowany do pliku stdout.
EnvironmentVariables	Opcjonalny String parametr tablicy. Tablica definicji zmiennych środowiskowych oddzielona średnikami. Każda definicja powinna określać nazwę zmiennej środowiskowej i wartość oddzieloną znakiem równości. Te zmienne są przekazywane do zduplikowanego pliku wykonywalnego oprócz zwykłego bloku środowiska lub selektywnego zastępowania. Na przykład Variable1=Value1;Variable2=Value2.
ExitCode	Opcjonalny Int32 parametr tylko do odczytu. Określa kod zakończenia udostępniany przez wykonane polecenie. Jeśli zadanie zarejestrowało błędy, ale proces miał kod zakończenia 0 (powodzenie), jest to ustawione na -1.
LogStandardErrorAsError	Opcjonalny bool parametr. Jeśli trueprogram , wszystkie komunikaty odebrane w standardowym strumieniu błędów są rejestrowane jako błędy.
StandardErrorImportance	Opcjonalny String parametr. Ważność rejestrowania tekstu ze standardowego strumienia błędów.
StandardOutputImportance	Opcjonalny String parametr. Ważność, za pomocą której ma być rejestrowany tekst ze standardowego strumienia wychodzącego.
Timeout	Opcjonalny Int32 parametr. Określa czas w milisekundach, po którym plik wykonywalny zadania zostanie zakończony. Wartość domyślna to Int.MaxValue, co oznacza, że nie ma limitu czasu. Limit czasu wynosi w milisekundach.
ToolExe	Opcjonalny string parametr. Projekty mogą implementować tę funkcję, aby zastąpić element ToolName. Zadania mogą zastąpić tę wartość, aby zachować wartość ToolName.
ToolPath	Opcjonalny string parametr. Określa lokalizację, z której zadanie ładuje źródłowy plik wykonywalny. Jeśli ten parametr nie zostanie określony, zadanie używa ścieżki instalacyjnej zestawu SDK odpowiadającej wersji platformy z uruchomionym programem MSBuild.
UseCommandProcessor	Opcjonalny bool parametr. Po ustawieniu truewartości to zadanie tworzy plik wsadowy dla wiersza polecenia i wykonuje go przy użyciu procesora poleceń zamiast bezpośredniego wykonywania polecenia.
YieldDuringToolExecution	Opcjonalny bool parametr. Gdy jest ustawiona wartość true, to zadanie daje węzeł, gdy jego zadanie jest wykonywane.

Przykład

Poniższy przykład tworzy zestaw z określonymi opcjami.

<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>

Zobacz też

• Dokumentacja zadania
• Zadania