RegisterAssembly görevi

  • Makale

Belirtilen derlemedeki meta verileri okur ve com istemcilerinin saydam bir şekilde .NET Framework sınıfları oluşturmasına olanak tanıyan gerekli girdileri kayıt defterine ekler. Bu görevin davranışı Regasm.exe (Derleme Kayıt aracı) ile benzerdir ancak aynı değildir.

Parametreler

Aşağıdaki tabloda görevin parametreleri RegisterAssembly açıklanmaktadır.

Parametre Tanım
Assemblies Gerekli ITaskItem[] parametresi.

COM ile kaydedilecek derlemeleri belirtir.
AssemblyListFile İsteğe bağlı ITaskItem parametre.

Görev ve UnregisterAssembly görevi arasındaki RegisterAssembly durum hakkında bilgi içerir. Bu bilgiler, görevin göreve kaydedilemeyen bir derlemenin kaydını kaldırmayı denemesini RegisterAssembly engellerUnregisterAssembly.
CreateCodeBase İsteğe bağlı Boolean parametre.

ise true, kayıt defterinde genel derleme önbelleğinde yüklü olmayan bir derlemenin dosya yolunu belirten bir kod tabanı girdisi oluşturur. Sonrasında genel derleme önbelleğine kaydettiriyor olduğunuz derlemeyi yükleyecekseniz bu seçeneği belirtmemelisiniz.
TypeLibFiles İsteğe bağlı ITaskItem[] çıkış parametresi.

Belirtilen derlemeden oluşturulacak tür kitaplığını belirtir. Oluşturulan tür kitaplığı, derleme içinde tanımlanan erişilebilir türlerin tanımlarını içerir. Tür kitaplığı yalnızca aşağıdaki koşullardan biri doğruysa oluşturulur:

- Bu adda bir tür kitaplığı bu konumda yok.
- Bir tür kitaplığı var ancak geçirilen derlemeden daha eski.

Tür kitaplığı geçirilen derlemeden daha yeniyse, yeni bir kitaplık oluşturulmaz, ancak derleme yine de kaydedilir.

Bu parametre belirtilirse, parametreyle aynı sayıda öğeye Assemblies sahip olmalıdır, aksi takdirde görev başarısız olur. Hiçbir giriş belirtilmezse, görev varsayılan olarak derlemenin adını alır ve öğenin uzantısını .tlb olarak değiştirir.

Açıklamalar

Yukarıda listelenen parametrelere ek olarak, bu görev kendi sınıfından TaskExtension devralan sınıfından Task parametreleri devralır. Bu ek parametrelerin ve açıklamalarının listesi için bkz . TaskExtension temel sınıfı.

Örnek

Aşağıdaki örnek, öğe koleksiyonu tarafından MyAssemblies belirtilen derlemeyi kaydetmek için görevini kullanırRegisterAssembly.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <MyAssemblies Include="MyAssembly.dll" />
    <ItemGroup>

    <Target Name="RegisterAssemblies">
        <RegisterAssembly
            Assemblies="@(MyAssemblies)" >
    </Target>

</Project>

Ayrıca bkz.