Nasıl yapılır: Tlbimp.exe Kullanarak Birincil Birlikte Çalışma Derlemeleri Oluşturma

  • Makale

Birincil birlikte çalışma derlemesi oluşturmanın iki yolu vardır:

  • Windows SDK tarafından sağlanan Tür Kitaplığı İçeri Aktarıcısı'nı (Tlbimp.exe) kullanma.

    Birincil birlikte çalışma derlemeleri oluşturmanın en basit yolu Tlbimp.exe (Tür Kitaplığı İçeri Aktarıcısı) kullanmaktır. Tlbimp.exe aşağıdaki korumaları sağlar:

    • İç içe geçmiş tür kitaplığı başvuruları için yeni birlikte çalışma derlemeleri oluşturmadan önce diğer kayıtlı birincil birlikte çalışma derlemelerini denetler.

    • Birincil birlikte çalışma derlemesine kesin bir ad vermek için kapsayıcıyı veya dosya adını belirtmezseniz birincil birlikte çalışma derlemesi yayılamaz.

    • Bağımlı derlemelere başvuruları atlarsanız birincil birlikte çalışma derlemesi yayılamaz.

    • Birincil birlikte çalışma derlemeleri olmayan bağımlı derlemelere başvurular eklerseniz birincil birlikte çalışma derlemesi yayılamaz.

  • C# gibi Ortak Dil Belirtimi (CLS) ile uyumlu bir dil kullanarak kaynak kodunda el ile birincil birlikte çalışma derlemeleri oluşturma. Bu yaklaşım, bir tür kitaplığı kullanılamadığında kullanışlıdır.

Derlemeyi kesin bir adla imzalamak için bir şifreleme anahtar çiftine sahip olmanız gerekir. Ayrıntılar için bkz . Anahtar Çifti Oluşturma.

Tlbimp.exe kullanarak birincil birlikte çalışma derlemesi oluşturmak için

  1. Komut istemine şunu yazın:

    tlbimptlbfile/primary /keyfile:filename/out:assemblyname

    Bu komutta, tlbfile COM tür kitaplığını içeren dosyadır, dosya adı anahtar çiftini içeren kapsayıcının veya dosyanın adıdır ve derleme adı da tanımlayıcı adla imzalanması gereken derlemenin adıdır.

Birincil birlikte çalışma derlemeleri yalnızca diğer birincil birlikte çalışma derlemelerine başvurabilir. Derlemeniz üçüncü taraf COM tür kitaplığındaki türlere başvuruda bulunursa, birincil birlikte çalışma derlemenizi oluşturabilmeniz için önce yayımcıdan bir birincil birlikte çalışma derlemesi almanız gerekir. Yayımcıysanız, başvuran birincil birlikte çalışma derlemesini oluşturmadan önce bağımlı tür kitaplığı için birincil birlikte çalışma derlemesi oluşturmanız gerekir.

Özgün tür kitaplığından farklı bir sürüm numarasına sahip bağımlı birincil birlikte çalışma derlemesi, geçerli dizine yüklendiğinde bulunamaz. Bağımlı birincil birlikte çalışma derlemesini Windows kayıt defterine kaydetmeniz veya Tlbimp.exe bağımlı DLL'yi bulduğundan emin olmak için /reference seçeneğini kullanmanız gerekir.

Bir tür kitaplığının birden çok sürümünü de sarmalayabilirsiniz. Yönergeler için bkz . Nasıl yapılır: Tür Kitaplıklarının Birden Çok Sürümünü Sarmalama.

Örnek

Aşağıdaki örnek, COM tür kitaplığını LibUtil.tlb içeri aktarır ve anahtar dosyasını CompanyA.snkkullanarak derlemeyi LibUtil.dll tanımlayıcı bir adla imzalar. Belirli bir ad alanı adını atlayarak, bu örnek varsayılan ad alanını LibUtiloluşturur.

tlbimp LibUtil.tlb /primary /keyfile:CompanyA.snk /out:LibUtil.dll

Daha açıklayıcı bir ad için (VendorName kullanılarak).LibraryName adlandırma kılavuzu), aşağıdaki örnek varsayılan derleme dosyası adını ve ad alanı adını geçersiz kılar.

tlbimp LibUtil.tlb /primary /keyfile:CompanyA.snk /namespace:CompanyA.LibUtil /out:CompanyA.LibUtil.dll

Aşağıdaki örnek, öğesine başvuran öğesini içeri aktarır MyLib.tlbve anahtar dosyasını CompanyB.snkkullanarak derlemeyi CompanyB.MyLib.dll kesin bir adla imzalarCompanyA.LibUtil.dll. ad alanı, CompanyB.MyLibvarsayılan ad alanı adını geçersiz kılar.

tlbimp MyLib.tlb /primary /keyfile:CompanyB.snk /namespace:CompanyB.MyLib /reference:CompanyA.LibUtil.dll /out:CompanyB.MyLib.dll

Ayrıca bkz.