al (Assembly Linker) görev

al görev AL.exe, bir aracı ile dağıtılmış sarar Windows Software Development Kit (SDK).Bu Assembly Linker aracı ya da modülleri olan bir veya daha fazla dosya ya da kaynak dosyaların bildirimi ile derleme oluşturmak için kullanılır.Bu görevi doğrudan kullanmak gerekli değildir genellikle derleyiciler ve geliştirme ortamları zaten bu yetenekleri sağlar, böylece.Assembly Linker karma dil geliştirme üretilen olanlar gibi birden çok bileşen dosyalarından tek bir derleme oluşturmak ihtiyaç duyan geliştiriciler için kullanışlıdır.Bu görevi modülleri bir tek derleme dosyada birleştirmek değil; yine de bağımsız modüller dağıtılmış ve sırayla doğru yüklemek oluşturulan derleme için kullanılabilir olması gerekir.AL.exe hakkında daha fazla bilgi için bkz: Al.exe (Assembly Linker).

Parametreler

Aşağıdaki tabloda parametrelerini açıklar AL görevi.

Parametre	Description
AlgorithmID	İsteğe bağlı String parametresi. Multifile derlemenin derleme bildirimi içeren dosya dışındaki tüm dosyaları karma bir algoritmayı belirtir.Daha fazla bilgi için belgelerine bakın /algid seçeneğini Al.exe (Assembly Linker).
BaseAddress	İsteğe bağlı String parametresi. Bir dll yüklenmesi adresini kullanıcının bilgisayarında zamanında belirtir.İşlem alanı DLL'lerdeki yükleyebileceğiniz işletim sisteminin izin vererek yerine DLL'leri taban adresi belirtirseniz, uygulamalar daha hızlı yüklenecektir.Bu parametre /base [Adres] seçeneğine karşılık gelir Al.exe (Assembly Linker).
CompanyName	İsteğe bağlı String parametresi. Bir dize belirtir Company alan derlemede.Daha fazla bilgi için belgelerine bakın /comp[any] seçeneğini Al.exe (Assembly Linker).
Configuration	İsteğe bağlı String parametresi. Bir dize belirtir Configuration alan derlemede.Daha fazla bilgi için belgelerine bakın /config[uration] seçeneğini Al.exe (Assembly Linker).
Copyright	İsteğe bağlı String parametresi. Bir dize belirtir Copyright alan derlemede.Daha fazla bilgi için belgelerine bakın /copy[right] seçeneğini Al.exe (Assembly Linker).
Culture	İsteğe bağlı String parametresi. Derleme ile ilişkilendirmek için kültür dizesini belirtir.Daha fazla bilgi için belgelerine bakın /c[ulture] seçeneğini Al.exe (Assembly Linker).
DelaySign	İsteğe bağlı Boolean parametresi. trueyalnızca ortak anahtar derlemede yerleştirmek için; falsetamamen Derlemeyi imzalamada kullanılacak.Daha fazla bilgi için belgelerine bakın /delay[sign] seçeneğini Al.exe (Assembly Linker).
Description	İsteğe bağlı String parametresi. Bir dize belirtir Description alan derlemede.Daha fazla bilgi için belgelerine bakın /descr[iption] seçeneğini Al.exe (Assembly Linker).
EmbedResources	İsteğe bağlı ITaskItem[] parametresi. Belirtilen kaynakları derleme bildirimi içeren resmi katıştırır.Bu görev, kaynak dosyanın içeriğini görüntüye kopyalar.Bu parametreye geçilen adlı Bunlara iliştirilen isteğe bağlı meta verileri öğeleriniz LogicalName ve Access.LogicalName Meta veri kaynağı için dahili tanımlayıcı belirtmek için kullanılır.Access Meta veriler ayarlanabilir private kaynak diğer derlemeler görünür hale getirmek için.Daha fazla bilgi için belgelerine bakın /embed[resource] seçeneğini Al.exe (Assembly Linker).
EvidenceFile	İsteğe bağlı String parametresi. Belirtilen dosya derleme kaynak adıyla katıştırır Security.Evidence. Kullanamazsınız Security.Evidence normal kaynaklar için.Bu parametre karşılık gelen /e[vidence] seçeneğini Al.exe (Assembly Linker).
ExitCode	İsteğe bağlı Int32 çıkış parametresi salt okunur. Yürütülen komut tarafından sağlanan çıkış kodunu belirtir.
FileVersion	İsteğe bağlı String parametresi. Bir dize belirtir File Version alan derlemede.Daha fazla bilgi için belgelerine bakın /fileversion seçeneğini Al.exe (Assembly Linker).
Flags	İsteğe bağlı String parametresi. İçin bir değer belirtir Flags alan derlemede.Daha fazla bilgi için belgelerine bakın /flags seçeneğini Al.exe (Assembly Linker).
GenerateFullPaths	İsteğe bağlı Boolean parametresi. Hata iletisinde bildirilen tüm dosyalar için mutlak bir yol kullanmak görevin neden olur.Bu parametre karşılık gelen /fullpaths seçeneğini Al.exe (Assembly Linker).
KeyContainer	İsteğe bağlı String parametresi. Bir anahtar çifti tutan bir kapsayıcı belirtir.Derlemeyi imzalamada (kesin ad verin) ortak anahtar derleme bildirimi ekleyerek.Görev özel anahtarla sonra son montaj imzalayın.Daha fazla bilgi için belgelerine bakın /keyn[ame] seçeneğini Al.exe (Assembly Linker).
KeyFile	İsteğe bağlı String parametresi. Derleme imzalamak için bir anahtar çifti ya da yalnızca ortak anahtar içeren bir dosyayı belirtir.Derleyici derleme bildirimi ortak anahtarını ekler ve ardından son montaj özel anahtarıyla imzalar.Daha fazla bilgi için belgelerine bakın /keyf[ile] seçeneğini Al.exe (Assembly Linker).
LinkResources	İsteğe bağlı ITaskItem[] parametresi. Belirtilen kaynak dosyaları bir derlemeye bağlar.Kaynak derlemesinin bir parçası haline gelir, ancak dosya kopyalanmaz.Bu parametreye geçilen adlı Bunlara iliştirilen isteğe bağlı meta verileri öğeleriniz LogicalName, Target, ve Access.LogicalName Meta veri kaynağı için dahili tanımlayıcı belirtmek için kullanılır.Target Yolunu ve dosya görev geçmesi derlenip derlenmediğini bu yeni dosyayı derlemeye dosyayı kopyalar meta verileri belirtebilirsiniz.Access Meta veriler ayarlanabilir private kaynak diğer derlemeler görünür hale getirmek için.Daha fazla bilgi için belgelerine bakın /link[resource] seçeneğini Al.exe (Assembly Linker).
MainEntryPoint	İsteğe bağlı String parametresi. Tam nitelikli adını belirtir (class.method) yönteminin bir modül bir yürütülebilir dosyaya dönüştürürken bir giriş noktası olarak kullanılacak.Bu parametre karşılık gelen /main seçeneğini Al.exe (Assembly Linker).
OutputAssembly	Gerekli ITaskItem çıkış parametresi. Bu görev tarafından oluşturulan dosyanın adını belirtir.Bu parametre karşılık gelen /out seçeneğini Al.exe (Assembly Linker).
Platform	İsteğe bağlı String parametresi. Bu kodun çalıştırılacağı hangi platform sınırlar; must be one of x86, Itanium, x64, or anycpu.Varsayılan, anycpu değeridir.Bu parametre karşılık gelen /platform seçeneğini Al.exe (Assembly Linker).
ProductName	İsteğe bağlı String parametresi. Bir dize belirtir Product alan derlemede.Daha fazla bilgi için belgelerine bakın /prod[uct] seçeneğini Al.exe (Assembly Linker).
ProductVersion	İsteğe bağlı String parametresi. Bir dize belirtir ProductVersion alan derlemede.Daha fazla bilgi için belgelerine bakın /productv[ersion] seçeneğini Al.exe (Assembly Linker).
ResponseFiles	İsteğe bağlı String[] parametresi. Assembly Linker geçmesine izin ek seçenekleri içeren yanıt dosyaları belirtir.
SdkToolsPath	İsteğe bağlı String parametresi. Resgen.exe gibi sdk araçlarını yolunu belirtir.
SourceModules	İsteğe bağlı ITaskItem[] parametresi. Bir derleme derlenmesi için bir veya daha fazla modülleri.Modüller sonuç derlemesinin bildiriminde listelenen ve hala dağıtılmış ve kullanılabilir durumda yüklenecek derleme için gerekecek.Bu parametre iletilen ek meta veri olarak adlandırılan öğeleriniz Target, yol ve dosya adı görev geçmesi derlenip derlenmediğini bu yeni dosyayı derlemeye dosyayı kopyalar belirtir.Daha fazla bilgi için belgelerine bakın Al.exe (Assembly Linker).Bu parametre Al.exe özel anahtarı olmadan geçirilen modüllerin listesini karşılık gelir.
TargetType	İsteğe bağlı String parametresi. Çıkış dosyasının dosya biçimini belirtir: library (kod kitaplığı) exe (konsol uygulaması), veya win (Windows tabanlı uygulama).Varsayılan, library değeridir.Bu parametre karşılık gelen /t[arget] seçeneğini Al.exe (Assembly Linker).
TemplateFile	İsteğe bağlı String parametresi. Kültür alanı dışında tüm derleme meta devralır derleme belirtir.Belirtilen derleme kesin adı olması gerekir. İle oluşturduğunuz bir derleme TemplateFile parametresi, bir uydu derleme olacaktır.Bu parametre karşılık gelen /template seçeneğini Al.exe (Assembly Linker).
Timeout	İsteğe bağlı Int32 parametresi. Süreyi geçmesi yürütülebilir görev sonlandırıldı milisaniye cinsinden belirtir.Varsayılan değer Int.MaxValue, hiçbir zaman aşımı süresi olduğunu belirten.
Title	İsteğe bağlı String parametresi. Bir dize belirtir Title alan derlemede.Daha fazla bilgi için belgelerine bakın /title seçeneğini Al.exe (Assembly Linker).
ToolPath	İsteğe bağlı String parametresi. Yerleşime Görev temel yürütülebilir dosya (Al.exe) nereye yükleneceğini belirtir.Bu parametre belirtilmezse, görevi çalıştıran framework sürümüne karşılık gelen sdk yükleme yolu kullanan MSBuild.
Trademark	İsteğe bağlı String parametresi. Bir dize belirtir Trademark alan derlemede.Daha fazla bilgi için belgelerine bakın /trade[mark] seçeneğini Al.exe (Assembly Linker).
Version	İsteğe bağlı String parametresi. Bu derleme için sürüm bilgilerini belirtir.Biçim dizesi ana.alt düzey.yapı.düzeltme.Varsayılan değer 0'dir.Daha fazla bilgi için belgelerine bakın /v[ersion] seçeneğini Al.exe (Assembly Linker).
Win32Icon	İsteğe bağlı String parametresi. .İco dosyası derleme ekler..İco dosyası çıktı dosyasının dosya Gezgini'nde istediğiniz görünümünü sağlar.Bu parametre karşılık gelen /win32icon seçeneğini Al.exe (Assembly Linker).
Win32Resource	İsteğe bağlı String parametresi. Win32 kaynağı (.res dosyası) çıktı dosyasına ekler.Daha fazla bilgi için belgelerine bakın /win32res seçeneğini Al.exe (Assembly Linker).

Notlar

Yukarıda listelenen parametrelere ek olarak, bu görevi parametrelerinden devralan ToolTaskExtension hangi kendisi sınıfı miras ToolTask sınıfı.Bu ek parametreler ve bunların açıklamalarının listesi için bkz: ToolTaskExtension temel sınıf.

Örnek

Aşağıdaki örnek, belirtilen seçeneklerle bir derleme oluşturur.

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

Ayrıca bkz.

Kavramlar

MSBuild görevleri

Diğer Kaynaklar

MSBuild görevi başvurusu