Regasm.exe (nástroj registrace sestavení)Regasm.exe (Assembly Registration Tool)

Nástroj Assembly Registration načte metadata v rámci sestavení a přidá nezbytné položky registru, které umožní klientům modelu COM transparentní vytvoření tříd rozhraní .NET Framework.The Assembly Registration tool reads the metadata within an assembly and adds the necessary entries to the registry, which allows COM clients to create .NET Framework classes transparently. Jakmile je třída zaregistrována, může ji libovolný klient COM použít jako třídu COM.Once a class is registered, any COM client can use it as though the class were a COM class. Třída je registrována pouze jednou, při instalaci sestavení.The class is registered only once, when the assembly is installed. Instance tříd z modelu COM v rámci sestavení nelze vytvořit, dokud nedojde k jejich registraci.Instances of classes within the assembly cannot be created from COM until they are actually registered.

Chcete-li spustit nástroj, použijte Developer Command Prompt pro Visual Studio.To run the tool, use the Developer Command Prompt for Visual Studio. Další informace najdete v tématu výzvy k zadání příkazu.For more information, see Command Prompts.

V příkazovém řádku zadejte následující:At the command prompt, type the following:

SyntaxeSyntax

regasm assemblyFile [options]

ParametryParameters

ParametrParameter PopisDescription
assemblyFileassemblyFile Sestavení, která mají být registrována pomocí modelu COM.The assembly to be registered with COM.
MožnostOption PopisDescription
/codebase/codebase Vytvoří položku základu kódu v registru.Creates a Codebase entry in the registry. Položka základu kódu určuje cestu k souboru sestavení, které není nainstalováno v globální mezipaměti sestavení (GAC).The Codebase entry specifies the file path for an assembly that is not installed in the global assembly cache. Tuto možnost byste neměli zadávat, pokud následně instalujete sestavení, které budete registrovat do globální mezipaměti sestavení (GAC).You should not specify this option if you will subsequently install the assembly that you are registering into the global assembly cache. Argument assemblyFile , který zadáte pomocí možnosti /codebase , musí být sestavení se silným názvem.The assemblyFile argument that you specify with the /codebase option must be a strong-named assembly.
/registered odkazuje/registered Určuje, že tento nástroj bude odkazovat pouze na knihovny typů, které již byly zaregistrovány.Specifies that this tool will only refer to type libraries that have already been registered.
/asmPath: adresář/asmpath:directory Určuje adresář obsahující odkazy na sestavení.Specifies a directory containing assembly references. Musí být použit s možností /regfile .Must be used with the /regfile option.
/nologo/nologo Potlačí zobrazení úvodního nápisu společnosti Microsoft.Suppresses the Microsoft startup banner display.
/regfile [ : regFile]/regfile [: regFile] Generuje soubor .reg určený pro sestavení, která obsahují potřebné položky registru.Generates the specified .reg file for the assembly, which contains the needed registry entries. Použití této možnosti nezmění registr.Specifying this option does not change the registry. Tuto možnost nelze použít s možnostmi /u nebo /TLB .You cannot use this option with the /u or /tlb options.
/Silent nebo /s/silent or /s Potlačí zobrazování zpráv o úspěšném dokončení.Suppresses the display of success messages.
/TLB [ : typeLibFile]/tlb [: typeLibFile] Ze zadaného sestavení vytvoří knihovnu typů obsahující definice dostupných typů definovaných v rámci sestavení.Generates a type library from the specified assembly containing definitions of the accessible types defined within the assembly.
/Unregister nebo /u/unregister or /u Zruší registraci tříd, které se v assemblyFilenacházejí.Unregisters the creatable classes found in assemblyFile. Vynechání této možnosti způsobí, že nástroj Regasm.exe zaregistruje vytvořitelné třídy v rámci sestavení.Omitting this option causes Regasm.exe to register the creatable classes in the assembly.
/verbose/verbose Určuje režim podrobného výpisu; Zobrazí seznam všech odkazovaných sestavení, pro které je třeba generovat knihovnu typů, pokud je zadána pomocí možnosti /TLB .Specifies verbose mode; displays a list of any referenced assemblies for which a type library needs to be generated, when specified with the /tlb option.
/?/? nebo /helpor /help Zobrazí syntaxi příkazu a možnosti nástroje.Displays command syntax and options for the tool.

Poznámka

Možnosti příkazového řádku nástroje Regasm.exe nerozlišují malá a velká písmena.The Regasm.exe command-line options are case insensitive. Pro jednoznačnou identifikaci je potřeba zadat dostatek parametrů.You only need to provide enough of the option to uniquely identify it. Například /n je ekvivalentem /nologo a /t: soubor. tlb je ekvivalentní k /TLB: soubor. tlb.For example, /n is equivalent to /nologo and /t: outfile.tlb is equivalent to /tlb: outfile.tlb.

PoznámkyRemarks

K vygenerování souboru. reg, který obsahuje položky registru, místo provedení změn přímo v registru můžete použít možnost /regfile .You can use the /regfile option to generate a .reg file that contains the registry entries instead of making the changes directly to the registry. Registr lze na počítači aktualizovat importováním souboru .reg pomocí nástroje Editor registru (Regedit.exe).You can update the registry on a computer by importing the .reg file with the Registry Editor tool (Regedit.exe). Soubor .reg neobsahuje žádné aktualizace registru, které lze provést pomocí funkcí registru definovaných uživatelem.Note that the .reg file does not contain any registry updates that can be made by user-defined register functions. Všimněte si, že možnost /regfile generuje pouze položky registru pro spravované třídy.Note that the /regfile option only emits registry entries for managed classes. Tato možnost negeneruje položky pro TypeLibIDs nebo InterfaceIDs.This option does not emit entries for TypeLibIDs or InterfaceIDs.

Pokud zadáte možnost /TLB , nástroj Regasm. exe vygeneruje a zaregistruje knihovnu typů popisující typy nalezené v sestavení.When you specify the /tlb option, Regasm.exe generates and registers a type library describing the types found in the assembly. Nástroj Regasm.exe umístí vytvořenou knihovnu typů do aktuálního pracovního adresáře nebo do adresáře určeného pro výstupní soubor.Regasm.exe places the generated type libraries in the current working directory or the directory specified for the output file. Vytváření knihovny typů pro sestavení, které odkazuje na jiné sestavení, může způsobit vytvoření několika knihoven typů najednou.Generating a type library for an assembly that references other assemblies may cause several type libraries to be generated at once. Knihovnu typů můžete použít k poskytnutí informací o typech vývojářským nástrojům, jako je Visual Studio.You can use the type library to provide type information to development tools like Visual Studio. Možnost /TLB byste neměli používat, pokud sestavení, které zaregistrujete, vytvořil Nástroj pro import knihovny typů (Tlbimp. exe).You should not use the /tlb option if the assembly you are registering was produced by the Type Library Importer (Tlbimp.exe). Knihovnu typů nelze exportovat ze sestavení, které bylo importováno z knihovny typů.You cannot export a type library from an assembly that was imported from a type library. Použití možnosti /TLB má stejný účinek jako použití exportéru knihovny typů (Tlbexp. exe) a Regasm. exe s výjimkou, že Tlbexp. exe neregistruje knihovnu typů, kterou vytváří.Using the /tlb option has the same effect as using the Type Library Exporter (Tlbexp.exe) and Regasm.exe, with the exception that Tlbexp.exe does not register the type library it produces. Použijete-li možnost /TLB k zaregistrování knihovny typů, můžete použít možnost /TLB s možností /Unregister pro zrušení registrace knihovny typů.If you use the /tlb option to registered a type library, you can use /tlb option with the /unregister option to unregistered the type library. Použitím obou možností společně dojde ke zrušení registrace knihovny typů a položek rozhraní, čímž lze značně pročistit registr.Using the two options together will unregister the type library and interface entries, which can clean the registry considerably.

Při registraci sestavení pro použití modelem COM nástroj Regasm.exe přidá položky do registru místního počítače.When you register an assembly for use by COM, Regasm.exe adds entries to the registry on the local computer. Přesněji řečeno vytvoří klíče registru závislé na verzi, které dovolují v počítači paralelně spustit více verzí stejného sestavení.More specifically, it creates version-dependent registry keys that allow multiple versions of the same assembly to run side by side on a computer. Při první registraci sestavení je pro sestavení vytvořen jeden klíč na nejvyšší úrovni a je vytvořen jedinečný podklíč pro konkrétní verzi.The first time an assembly is registered, one top-level key is created for the assembly and a unique subkey is created for the specific version. Při každé registraci nové verze sestavení nástroj Regasm.exe vytvoří podklíč pro novou verzi.Each time you register a new version of the assembly, Regasm.exe creates a subkey for the new version.

Jako příklad lze uvést registraci spravované komponenty, myComp.dll, verze 1.0.0.0 pro použití modelem COM.For example, consider a scenario where you register the managed component, myComp.dll, version 1.0.0.0 for use by COM. Později zaregistrujete myComp.dll verze 2.0.0.0.Later, you register myComp.dll, version 2.0.0.0. Je možné určit, že všechny klientské aplikace modelu COM v počítači používají myComp.dll verze 2.0.0.0 a rozhodnout o zrušení registrace myComponent.dll verze 1.0.0.0.You determine that all COM client applications on the computer are using myComp.dll version 2.0.0.0 and you decide to unregister myComponent.dll version 1.0.0.0. Toto schéma registru umožňuje zrušit registraci myComp.dll verze 1.0.0.0, protože je odebrán pouze podklíč verze 1.0.0.0.This registry scheme allows you to unregister myComp.dll version 1.0.0.0 because only the version 1.0.0.0 subkey is removed.

Po registraci sestavení pomocí nástroje Regasm. exe jej můžete nainstalovat do globální mezipaměti sestavení (GAC ), aby jej bylo možné aktivovat z libovolného klienta modelu COM.After registering an assembly using Regasm.exe, you can install it in the global assembly cache so that it can be activated from any COM client. Pokud bude sestavení aktivováno jednou aplikací, je možné je umístit do adresáře dané aplikace.If the assembly is only going to be activated by a single application, you can place it in that application's directory.

PříkladyExamples

Následující příkaz registruje všechny veřejné třídy obsažené v myTest.dll.The following command registers all public classes contained in myTest.dll.

regasm myTest.dll

Následující příkaz vygeneruje soubor myTest.reg, který obsahuje všechny nezbytné položky registru.The following command generates the file myTest.reg, which contains all the necessary registry entries. Tento příkaz neprovede aktualizaci registru.This command does not update the registry.

regasm myTest.dll /regfile:myTest.reg

Následující příkaz registruje všechny veřejné třídy obsažené v myTest.dlla generuje a zaregistruje knihovnu myTest.tlbtypů, která obsahuje definice všech veřejných typů definovaných v myTest.dll.The following command registers all public classes contained in myTest.dll, and generates and registers the type library myTest.tlb, which contains definitions of all the public types defined in myTest.dll.

regasm myTest.dll /tlb:myTest.tlb

Viz také:See also