RegistrationHelper.InstallAssembly Metoda

Definice

Obor názvů:

System.EnterpriseServices

Sestavení:

System.EnterpriseServices.dll

Poskytuje součásti za běhu, které jsou k dispozici v katalogu modelu COM+.

Přetížení

InstallAssembly(String, String, String, InstallationFlags)	Nainstaluje pojmenované sestavení do aplikace modelu COM+.
InstallAssembly(String, String, String, String, InstallationFlags)	Nainstaluje pojmenované sestavení do aplikace modelu COM+.

InstallAssembly(String, String, String, InstallationFlags)

Nainstaluje pojmenované sestavení do aplikace modelu COM+.

public:
 virtual void InstallAssembly(System::String ^ assembly, System::String ^ % application, System::String ^ % tlb, System::EnterpriseServices::InstallationFlags installFlags);

public void InstallAssembly (string assembly, ref string application, ref string tlb, System.EnterpriseServices.InstallationFlags installFlags);

abstract member InstallAssembly : string * string * string * System.EnterpriseServices.InstallationFlags -> unit
override this.InstallAssembly : string * string * string * System.EnterpriseServices.InstallationFlags -> unit

Public Sub InstallAssembly (assembly As String, ByRef application As String, ByRef tlb As String, installFlags As InstallationFlags)

Parametry

assembly

String

Název souboru sestavení, které se má nainstalovat.

application

String

Název aplikace modelu COM+, do které se má nainstalovat. Tento parametr může být null. Pokud je null parametr a sestavení obsahuje ApplicationNameAttribute, použije se atribut . V opačném případě se název aplikace vygeneruje na základě názvu sestavení a pak se vrátí.

tlb

String

Název výstupního souboru nástroje pro export knihovny typů (Tlbexp.exe) nebo řetězec, který obsahuje null , pokud se očekává, že tento název vygeneruje pomocník pro registraci. Skutečný použitý název se umístí do parametru při dokončení volání.

installFlags

InstallationFlags

Bitové kombinace InstallationFlags hodnot.

Implementuje

InstallAssembly(String, String, String, InstallationFlags)

Výjimky

RegistrationException

Vstupní sestavení nemá silný název.

Příklady

Následující příklad kódu ukazuje, jak použít metodu InstalAssembly k instalaci pojmenovaného sestavení v aplikaci modelu COM+.

String^ applicationName = "Queued Component";
String^ typeLibraryName = nullptr;
RegistrationHelper^ helper = gcnew RegistrationHelper;
// Call the InstallAssembly method passing it the name of the assembly to 
// install as a COM+ application, the COM+ application name, and 
// the name of the type library file.
// Setting the application name and the type library to NULL (nothing in Visual Basic .NET
// allows you to use the COM+ application name that is given in the assembly and 
// the default type library name. The application name in the assembly metadata 
// takes precedence over the application name you provide to InstallAssembly. 
helper->InstallAssembly( "C:..\\..\\QueuedComponent.dll",  applicationName,  typeLibraryName, InstallationFlags::CreateTargetApplication );
Console::WriteLine( "Registration succeeded: Type library {0} created.", typeLibraryName );
Console::Read();

string applicationName = "Queued Component";			
string typeLibraryName = null;
RegistrationHelper helper = new RegistrationHelper();
// Call the InstallAssembly method passing it the name of the assembly to
// install as a COM+ application, the COM+ application name, and
// the name of the type library file.
// Setting the application name and the type library to NULL (nothing in Visual Basic .NET
// allows you to use the COM+ application name that is given in the assembly and
// the default type library name. The application name in the assembly metadata
// takes precedence over the application name you provide to InstallAssembly.
helper.InstallAssembly(@"C:..\..\QueuedComponent.dll", ref applicationName, ref typeLibraryName, InstallationFlags.CreateTargetApplication);
Console.WriteLine("Registration succeeded: Type library {0} created.", typeLibraryName);
Console.Read();

Dim applicationName As String = "Queued Component"
Dim typeLibraryName As String = Nothing
Dim helper As New RegistrationHelper

' Call the InstallAssembly method passing it the name of the assembly to 
' install as a COM+ application, the COM+ application name, and 
' the name of the type library file.
' Setting the application name and the type library to NULL (nothing in Visual Basic .NET
' allows you to use the COM+ application name that is given in the assembly and 
' the default type library name. The application name in the assembly metadata 
' takes precedence over the application name you provide to InstallAssembly. 
helper.InstallAssembly("C:..\..\QueuedComponent.dll", applicationName, typeLibraryName, InstallationFlags.CreateTargetApplication)
MsgBox("Registration succeeded: Type library " & typeLibraryName & " created.")
Console.Read()

Poznámky

InstallAssembly provede následující kroky: registraci, generování knihovny typů, registraci knihovny typů, instalaci knihovny typů v zadané aplikaci a konfiguraci komponent obsažených v knihovně typů.

Tato metoda vyžaduje, aby volající měl v místním počítači oprávnění správce.

InstallAssembly(String, String, String, String, InstallationFlags)

Nainstaluje pojmenované sestavení do aplikace modelu COM+.

public:
 void InstallAssembly(System::String ^ assembly, System::String ^ % application, System::String ^ partition, System::String ^ % tlb, System::EnterpriseServices::InstallationFlags installFlags);

public void InstallAssembly (string assembly, ref string application, string partition, ref string tlb, System.EnterpriseServices.InstallationFlags installFlags);

member this.InstallAssembly : string * string * string * string * System.EnterpriseServices.InstallationFlags -> unit

Public Sub InstallAssembly (assembly As String, ByRef application As String, partition As String, ByRef tlb As String, installFlags As InstallationFlags)

Parametry

assembly

String

Název souboru sestavení, které se má nainstalovat.

application

String

Název aplikace modelu COM+, do které se má nainstalovat. Tento parametr může být null. Pokud je null parametr a sestavení obsahuje ApplicationNameAttribute, použije se atribut . V opačném případě se název aplikace vygeneruje na základě názvu sestavení a pak se vrátí.

partition

String

Název oddílu. Tento parametr může být null.

tlb

String

Název výstupního souboru nástroje pro export knihovny typů (Tlbexp.exe) nebo řetězec, který obsahuje null , pokud se očekává, že tento název vygeneruje pomocník pro registraci. Skutečný použitý název se umístí do parametru při dokončení volání.

installFlags

InstallationFlags

Bitové kombinace InstallationFlags hodnot.

Výjimky

RegistrationException

Vstupní sestavení nemá silný název.

Poznámky

InstallAssembly provede následující kroky: registraci, generování knihovny typů, registraci knihovny typů, instalaci knihovny typů v zadané aplikaci a konfiguraci komponent obsažených v knihovně typů.

Tato metoda vyžaduje, aby volající měl v místním počítači oprávnění správce.