RegistrationHelper.InstallAssembly Metodo

Definizione

Fornisce i componenti di runtime disponibili per il catalogo COM+.Provides the run-time components available to the COM+ catalog.

Overload

InstallAssembly(String, String, String, InstallationFlags)

Consente di installare l'assembly denominato in un'applicazione COM+.Installs the named assembly in a COM+ application.

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

Consente di installare l'assembly denominato in un'applicazione COM+.Installs the named assembly in a COM+ application.

InstallAssembly(String, String, String, InstallationFlags)

Consente di installare l'assembly denominato in un'applicazione COM+.Installs the named assembly in a COM+ application.

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)

Parametri

assembly
String

Nome file dell'assembly da installare.The file name of the assembly to install.

application
String

Nome dell'applicazione COM+ in cui eseguire l'installazione.The name of the COM+ application to install into. Questo parametro può essere null.This parameter can be null. Se il parametro è null e l'assembly contiene ApplicationNameAttribute, viene utilizzato l'attributo.If the parameter is null and the assembly contains a ApplicationNameAttribute, then the attribute is used. In caso contrario, il nome dell'applicazione viene generato in base al nome dell'assembly, quindi viene restituito.Otherwise, the name of the application is generated based on the name of the assembly, then is returned.

tlb
String

Nome del file di output dell'utilità di esportazione della libreria dei tipi (Tlbexp.exe) o stringa contenente null se si prevede che il supporto per la registrazione generi il nome.The name of the output Type Library Exporter (Tlbexp.exe) file, or a string that contains null if the registration helper is expected to generate the name. Al termine della chiamata, il nome utilizzato viene inserito nel parametro.The actual name used is placed in the parameter on call completion.

installFlags
InstallationFlags

Combinazione bit per bit dei valori di InstallationFlags.A bitwise combination of the InstallationFlags values.

Implementazioni

Eccezioni

L'assembly di input non dispone di un nome sicuro.The input assembly does not have a strong name.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato InstalAssembly come utilizzare il metodo per installare un assembly denominato in un'applicazione com+.The following code example shows how to use the InstalAssembly method to install a named assembly in a COM+ application.

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

Commenti

InstallAssemblyesegue i passaggi seguenti: registrazione, generazione di una libreria dei tipi, registrazione della libreria dei tipi, installazione della libreria dei tipi nell'applicazione specificata e configurazione dei componenti contenuti nella libreria dei tipi.InstallAssembly performs the following steps: registration, generation of a type library, registration of the type library, installation of the type library under the specified application, and configuration of the components contained in the type library.

Questo metodo richiede che il chiamante disponga dei privilegi amministrativi nel computer locale.This method requires the caller to have administrative privileges on the local computer.

Sicurezza

SecurityPermission
per la possibilità di accedere al codice non gestito.for the ability to access unmanaged code. Enumerazione associata:UnmanagedCodeAssociated enumeration: UnmanagedCode

RegistryPermission
per la possibilità di accedere al registro di sistema.for the ability to access the registry. Enumerazione associata:UnrestrictedAssociated enumeration: Unrestricted

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

Consente di installare l'assembly denominato in un'applicazione COM+.Installs the named assembly in a COM+ application.

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)

Parametri

assembly
String

Nome file dell'assembly da installare.The file name of the assembly to install.

application
String

Nome dell'applicazione COM+ in cui eseguire l'installazione.The name of the COM+ application to install into. Questo parametro può essere null.This parameter can be null. Se il parametro è null e l'assembly contiene ApplicationNameAttribute, viene utilizzato l'attributo.If the parameter is null and the assembly contains a ApplicationNameAttribute, then the attribute is used. In caso contrario, il nome dell'applicazione viene generato in base al nome dell'assembly, quindi viene restituito.Otherwise, the name of the application is generated based on the name of the assembly, then is returned.

partition
String

Nome della partizione.The name of the partition. Questo parametro può essere null.This parameter can be null.

tlb
String

Nome del file di output dell'utilità di esportazione della libreria dei tipi (Tlbexp.exe) o stringa contenente null se si prevede che il supporto per la registrazione generi il nome.The name of the output Type Library Exporter (Tlbexp.exe) file, or a string that contains null if the registration helper is expected to generate the name. Al termine della chiamata, il nome utilizzato viene inserito nel parametro.The actual name used is placed in the parameter on call completion.

installFlags
InstallationFlags

Combinazione bit per bit dei valori di InstallationFlags.A bitwise combination of the InstallationFlags values.

Eccezioni

L'assembly di input non dispone di un nome sicuro.The input assembly does not have a strong name.

Commenti

InstallAssemblyesegue i passaggi seguenti: registrazione, generazione di una libreria dei tipi, registrazione della libreria dei tipi, installazione della libreria dei tipi nell'applicazione specificata e configurazione dei componenti contenuti nella libreria dei tipi.InstallAssembly performs the following steps: registration, generation of a type library, registration of the type library, installation of the type library under the specified application, and configuration of the components contained in the type library.

Questo metodo richiede che il chiamante disponga dei privilegi amministrativi nel computer locale.This method requires the caller to have administrative privileges on the local computer.

Sicurezza

SecurityPermission
per la possibilità di accedere al codice non gestito.for the ability to access unmanaged code. Enumerazione associata:UnmanagedCodeAssociated enumeration: UnmanagedCode

RegistryPermission
per la possibilità di accedere al registro di sistema.for the ability to access the registry. Enumerazione associata:UnrestrictedAssociated enumeration: Unrestricted

Si applica a