RegistrationHelper.InstallAssembly Metodo

Definizione

Spazio dei nomi:: System.EnterpriseServices

Assembly:: System.EnterpriseServices.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce i componenti di runtime disponibili per il catalogo COM+.

Overload

Nome	Descrizione
InstallAssembly(String, String, String, InstallationFlags)	Installa l'assembly denominato in un'applicazione COM+.
InstallAssembly(String, String, String, String, InstallationFlags)	Installa l'assembly denominato in un'applicazione COM+.

InstallAssembly(String, String, String, InstallationFlags)

Installa l'assembly denominato in un'applicazione 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)

Parametri

assembly: String

Nome file dell'assembly da installare.

application: String

Nome dell'applicazione COM+ in cui eseguire l'installazione. Questo parametro può essere null. Se il parametro è null e l'assembly contiene un ApplicationNameAttributeoggetto , viene usato l'attributo . In caso contrario, viene restituito il nome dell'applicazione in base al nome dell'assembly.

tlb: String

Nome del file dell'utilità di esportazione della libreria dei tipi di output (Tlbexp.exe) o stringa che contiene null se si prevede che l'helper di registrazione generi il nome. Il nome effettivo usato viene inserito nel parametro al completamento della chiamata.

installFlags: InstallationFlags

Combinazione bit per bit dei InstallationFlags valori.

Implementazioni

InstallAssembly(String, String, String, InstallationFlags)

Eccezioni

RegistrationException

L'assembly di input non ha un nome sicuro.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il InstalAssembly metodo per installare un assembly denominato in un'applicazione 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()

Commenti

InstallAssembly esegue 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.

Questo metodo richiede al chiamante di disporre di privilegi amministrativi nel computer locale.

Si applica a

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