RegistrationHelper.InstallAssembly Methode

Definition

Stellt die für den COM+-Katalog verfügbaren Laufzeitkomponenten bereit.

Überlädt

InstallAssembly(String, String, String, InstallationFlags)

Installiert die benannte Assembly in einer COM+-Anwendung.

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

Installiert die benannte Assembly in einer COM+-Anwendung.

InstallAssembly(String, String, String, InstallationFlags)

Installiert die benannte Assembly in einer COM+-Anwendung.

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)

Parameter

assembly
String

Der Dateiname der zu installierenden Assembly.

application
String

Der Name der COM+-Anwendung, in der die Installation erfolgen soll. Dieser Parameter kann null sein. Wenn der Parameter null ist und die Assembly ein ApplicationNameAttribute enthält, wird das Attribut verwendet. Andernfalls wird der Name der Anwendung auf der Grundlage des Assemblynamens generiert und anschließend zurückgegeben.

tlb
String

Der Name der vom Typbibliothek-Exportierprogramm (Tlbexp.exe) ausgegebenen Datei oder eine Zeichenfolge, die null enthält, wenn der Name vom Registrierungshilfsprogramm generiert werden soll. Bei Aufrufbeendigung wird der tatsächlich verwendete Name im Parameter abgelegt.

installFlags
InstallationFlags

Eine bitweise Kombination der InstallationFlags-Werte.

Implementiert

Ausnahmen

Die Eingabeassembly besitzt keinen starken Namen.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie die InstalAssembly -Methode verwenden, um eine benannte Assembly in einer COM+-Anwendung zu installieren.

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()

Hinweise

InstallAssembly führt die folgenden Schritte aus: Registrierung, Generierung einer Typbibliothek, Registrierung der Typbibliothek, Installation der Typbibliothek unter der angegebenen Anwendung und Konfiguration der in der Typbibliothek enthaltenen Komponenten.

Diese Methode erfordert, dass der Aufrufer über Administratorrechte auf dem lokalen Computer verfügt.

Gilt für:

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

Installiert die benannte Assembly in einer COM+-Anwendung.

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)

Parameter

assembly
String

Der Dateiname der zu installierenden Assembly.

application
String

Der Name der COM+-Anwendung, in der die Installation erfolgen soll. Dieser Parameter kann null sein. Wenn der Parameter null ist und die Assembly ein ApplicationNameAttribute enthält, wird das Attribut verwendet. Andernfalls wird der Name der Anwendung auf der Grundlage des Assemblynamens generiert und anschließend zurückgegeben.

partition
String

Der Name der Partition. Dieser Parameter kann null sein.

tlb
String

Der Name der vom Typbibliothek-Exportierprogramm (Tlbexp.exe) ausgegebenen Datei oder eine Zeichenfolge, die null enthält, wenn der Name vom Registrierungshilfsprogramm generiert werden soll. Bei Aufrufbeendigung wird der tatsächlich verwendete Name im Parameter abgelegt.

installFlags
InstallationFlags

Eine bitweise Kombination der InstallationFlags-Werte.

Ausnahmen

Die Eingabeassembly besitzt keinen starken Namen.

Hinweise

InstallAssembly führt die folgenden Schritte aus: Registrierung, Generierung einer Typbibliothek, Registrierung der Typbibliothek, Installation der Typbibliothek unter der angegebenen Anwendung und Konfiguration der in der Typbibliothek enthaltenen Komponenten.

Diese Methode erfordert, dass der Aufrufer über Administratorrechte auf dem lokalen Computer verfügt.

Gilt für: