RegistrationHelper.InstallAssembly 方法

定义

命名空间:

System.EnterpriseServices

程序集:

System.EnterpriseServices.dll

提供可用于 COM+ 目录的运行时组件。

重载

InstallAssembly(String, String, String, InstallationFlags)	在 COM+ 应用程序中安装命名的程序集。
InstallAssembly(String, String, String, String, InstallationFlags)	在 COM+ 应用程序中安装命名的程序集。

InstallAssembly(String, String, String, InstallationFlags)

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

参数

assembly

String

要安装的程序集的文件名。

application

String

安装到的 COM+ 应用程序的名称。 此参数可以为 null。 如果参数为 null 并且程序集包含 ApplicationNameAttribute，则使用该特性。 否则，会根据程序集的名称生成应用程序的名称，然后返回应用程序的名称。

tlb

String

输出类型库导出程序 (Tlbexp.exe) 文件的名称；如果要求注册帮助器生成该名称，则为包含 null 的字符串。 调用完成后将所用的实际名称放在此参数中。

installFlags

InstallationFlags

InstallationFlags 值的按位组合。

实现

InstallAssembly(String, String, String, InstallationFlags)

例外

RegistrationException

输入程序集没有强名称。

示例

下面的代码示例演示如何使用 InstalAssembly 方法在 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()

注解

InstallAssembly 执行以下步骤：注册、生成类型库、注册类型库、在指定应用程序下安装类型库，以及配置类型库中包含的组件。

此方法要求调用方在本地计算机上具有管理权限。

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

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

参数

assembly

String

要安装的程序集的文件名。

application

String

安装到的 COM+ 应用程序的名称。 此参数可以为 null。 如果参数为 null 并且程序集包含 ApplicationNameAttribute，则使用该特性。 否则，会根据程序集的名称生成应用程序的名称，然后返回应用程序的名称。

partition

String

分区的名称。 此参数可以为 null。

tlb

String

输出类型库导出程序 (Tlbexp.exe) 文件的名称；如果要求注册帮助器生成该名称，则为包含 null 的字符串。 调用完成后将所用的实际名称放在此参数中。

installFlags

InstallationFlags

InstallationFlags 值的按位组合。

例外

RegistrationException

输入程序集没有强名称。

注解

InstallAssembly 执行以下步骤：注册、生成类型库、注册类型库、在指定应用程序下安装类型库，以及配置类型库中包含的组件。

此方法要求调用方在本地计算机上具有管理权限。