Postupy: Generování primárních sestavení vzájemné spolupráce pomocí Tlbimp.exe
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
Na příkazovém řádku zadejte:
tlbimp tlbfile /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.snk
klíč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.snk
klíče . Obor názvů , CompanyB.MyLib
př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