Postupy: Generování primárních sestavení vzájemné spolupráce pomocí Tlbimp.exe

  • Článek

Primární sestavení vzájemné spolupráce můžete vygenerovat dvěma způsoby:

  • Použití nástroje Type Library Importer (Tlbimp.exe) poskytované sadou Windows SDK.

    Nejjednodušší způsob, jak vytvořit primární sestavení vzájemné spolupráce, je použít Tlbimp.exe (Type Library Importer). Tlbimp.exe poskytuje následující záruky:

    • Kontroluje další zaregistrovaná primární sestavení vzájemné spolupráce před vytvořením nových sestavení vzájemné spolupráce pro všechny vnořené odkazy knihovny typů.

    • Pokud neurčujete název kontejneru nebo souboru tak, aby primární sestavení vzájemné spolupráce zadalo silný název, nepodaří se vygenerovat primární sestavení vzájemné spolupráce.

    • Pokud vynecháte odkazy na závislá sestavení, nepodaří se vygenerovat primární sestavení vzájemné spolupráce.

    • Pokud přidáte odkazy na závislá sestavení, která nejsou primárními sestaveními vzájemné spolupráce, nevygeneruje primární sestavení vzájemné spolupráce.

  • Ruční vytváření primárních sestavení vzájemné spolupráce ve zdrojovém kódu pomocí jazyka, který je kompatibilní se specifikací CLS (Common Language Specification), například C#. Tento přístup je užitečný v případě, že knihovna typů není k dispozici.

K podepsání sestavení silným názvem musíte mít pár kryptografických klíčů. Podrobnosti najdete v tématu Vytvoření páru klíčů.

Generování primárního sestavení vzájemné spolupráce pomocí Tlbimp.exe

  1. Na příkazovém řádku zadejte:

    tlbimptlbfile/primary /keyfile:filename/out:assemblyname

    V tomto příkazu je tlbfile soubor obsahující knihovnu typů modelu COM, název souboru je název kontejneru nebo souboru, který obsahuje dvojici klíčů, a název sestavení je název sestavení, který se má podepsat silným názvem.

Primární sestavení vzájemné spolupráce mohou odkazovat pouze na jiná primární sestavení vzájemné spolupráce. Pokud vaše sestavení odkazuje na typy z knihovny typů modelu COM třetí strany, musíte před vygenerování primárního sestavení vzájemné spolupráce od vydavatele získat primární sestavení vzájemné spolupráce. Pokud jste vydavatelem, musíte před generováním odkazujícího primárního sestavení vzájemné spolupráce pro knihovnu závislých typů vygenerovat primární sestavení vzájemné spolupráce.

Závislé primární sestavení vzájemné spolupráce s číslem verze, které se liší od sestavení původní knihovny typů, není při instalaci v aktuálním adresáři zjistitelné. Je nutné buď zaregistrovat závislé primární sestavení vzájemné spolupráce v registru Systému Windows, nebo použít možnost /reference , abyste měli jistotu, že Tlbimp.exe najde závislé knihovny DLL.

Můžete také zabalit více verzí knihovny typů. Pokyny najdete v tématu Postupy: Zabalení více verzí knihoven typů.

Příklad

Následující příklad importuje knihovnu LibUtil.tlb typů modelu COM a podepíše sestavení LibUtil.dll silným názvem pomocí souboru CompanyA.snkklíče . Vynecháním konkrétního názvu oboru názvů tento příklad vytvoří výchozí obor názvů , LibUtil.

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

Popisnější název (pomocí VendorName).Průvodce pojmenováním LibraryName ) následující příklad přepíše výchozí název souboru sestavení a název oboru názvů.

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

Následující příklad naimportuje MyLib.tlb, který odkazuje CompanyA.LibUtil.dll, a podepíše sestavení CompanyB.MyLib.dll silným názvem pomocí souboru CompanyB.snkklíče . Obor názvů , CompanyB.MyLibpřepíše výchozí název oboru názvů.

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

Viz také