AssemblyInstaller Klasse

Definition

Namespace:: System.Configuration.Install

Assembly:: System.Configuration.Install.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Lädt eine Assembly und führt alle Installationsprogramme darin aus.

public ref class AssemblyInstaller : System::Configuration::Install::Installer

public class AssemblyInstaller : System.Configuration.Install.Installer

type AssemblyInstaller = class
    inherit Installer

Public Class AssemblyInstaller
Inherits Installer

Vererbung: Object

MarshalByRefObject

Component

Installer
AssemblyInstaller

Beispiele

Im folgenden Beispiel wird eine AssemblyInstaller durch Aufrufen des AssemblyInstaller Konstruktors erstellt. Die Eigenschaften dieses Objekts werden festgelegt, und die Install Methoden Commit werden aufgerufen, um die MyAssembly.exe Assembly zu installieren.

#using <System.dll>
#using <System.Configuration.Install.dll>

using namespace System;
using namespace System::Configuration::Install;
using namespace System::Collections;
using namespace System::Collections::Specialized;
int main()
{
   IDictionary^ mySavedState = gcnew Hashtable;
   Console::WriteLine( "" );
   try
   {
      
      // Set the commandline argument array for 'logfile'.
      array<String^>^commandLineOptions = {"/LogFile=example.log"};
      
      // Create an object of the 'AssemblyInstaller' class.
      AssemblyInstaller^ myAssemblyInstaller = gcnew AssemblyInstaller(
         "MyAssembly.exe", commandLineOptions );
      myAssemblyInstaller->UseNewContext = true;
      
      // Install the 'MyAssembly' assembly.
      myAssemblyInstaller->Install( mySavedState );
      
      // Commit the 'MyAssembly' assembly.
      myAssemblyInstaller->Commit( mySavedState );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( e->Message );
   }
}

using System;
using System.Configuration.Install;
using System.Collections;
using System.Collections.Specialized;

class AssemblyInstaller_Example
{
   static void Main()
   {
      IDictionary mySavedState = new Hashtable();

      Console.WriteLine( "" );

      try
      {
         // Set the commandline argument array for 'logfile'.
         string[] commandLineOptions = new string[ 1 ] {"/LogFile=example.log"};

         // Create an object of the 'AssemblyInstaller' class.
         AssemblyInstaller myAssemblyInstaller = new
                     AssemblyInstaller( "MyAssembly.exe" , commandLineOptions );

         myAssemblyInstaller.UseNewContext = true;

         // Install the 'MyAssembly' assembly.
         myAssemblyInstaller.Install( mySavedState );

         // Commit the 'MyAssembly' assembly.
         myAssemblyInstaller.Commit( mySavedState );
      }
      catch (Exception e)
      {
         Console.WriteLine( e.Message );
      }
   }
}

Imports System.Configuration.Install
Imports System.Collections
Imports System.Collections.Specialized

Class AssemblyInstaller_Example

   Shared Sub Main()
      Dim mySavedState = New Hashtable()

      Console.WriteLine("")

      Try
         ' Set the commandline argument array for 'logfile'.
         Dim commandLineOptions(0) As String
         commandLineOptions(0) = "/LogFile=example.log"

         ' Create an object of the 'AssemblyInstaller' class.
         Dim myAssemblyInstaller As _
               New AssemblyInstaller("MyAssembly.exe", commandLineOptions)

         myAssemblyInstaller.UseNewContext = True

         ' Install the 'MyAssembly' assembly.
         myAssemblyInstaller.Install(mySavedState)

         ' Commit the 'MyAssembly' assembly.
         myAssemblyInstaller.Commit(mySavedState)
      Catch e As Exception
         Console.WriteLine(e.Message)
      End Try
   End Sub
End Class

Konstruktoren

Name	Beschreibung
AssemblyInstaller()	Initialisiert eine neue Instanz der AssemblyInstaller-Klasse.
AssemblyInstaller(Assembly, String[])	Initialisiert eine neue Instanz der AssemblyInstaller Klasse und gibt sowohl die zu installierende Assembly als auch die Befehlszeile an, die beim Erstellen eines neuen InstallContext Objekts verwendet werden soll.
AssemblyInstaller(String, String[])	Initialisiert eine neue Instanz der AssemblyInstaller Klasse und gibt sowohl den Dateinamen der zu installierenden Assembly als auch die Befehlszeile an, die beim Erstellen eines neuen InstallContext Objekts für die Installation der Assembly verwendet werden soll.

Eigenschaften

Name	Beschreibung
Assembly	Ruft die zu installierende Assembly ab oder legt sie fest.
CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
CommandLine	Ruft die Befehlszeile ab, die beim Erstellen eines neuen InstallContext Objekts für die Installation der Assembly verwendet werden soll, oder legt diese fest.
Container	Ruft das, das IContainer die Component. (Geerbt von Component)
Context	Ruft Informationen zur aktuellen Installation ab oder legt diese fest. (Geerbt von Installer)
DesignMode	Ruft einen Wert ab, der angibt, ob sich der Component Entwurfsmodus derzeit befindet. (Geerbt von Component)
Events	Ruft die Liste der Ereignishandler ab, die an diese Componentangefügt sind. (Geerbt von Component)
HelpText	Ruft den Hilfetext für alle Installationsprogramme in der Installer-Auflistung ab.
Installers	Ruft die Auflistung der Installationsprogramme ab, die dieses Installationsprogramm enthält. (Geerbt von Installer)
Parent	Ruft das Installationsprogramm ab, das die Auflistung enthält, zu der dieses Installationsprogramm gehört, oder legt diesen fest. (Geerbt von Installer)
Path	Ruft den Pfad der zu installierenden Assembly ab oder legt diesen fest.
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
UseNewContext	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein neues InstallContext Objekt für die Installation der Assembly erstellt werden soll.

Methoden

Name	Beschreibung
CheckIfInstallable(String)	Überprüft, ob die angegebene Assembly installiert werden kann.
Commit(IDictionary)	Schließt die Installationstransaktion ab.
CreateObjRef(Type)	Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject)
Dispose()	Veröffentlicht alle ressourcen, die von der Component. (Geerbt von Component)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den Component verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von Component)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetService(Type)	Gibt ein Objekt zurück, das einen Dienst darstellt, der von der Component oder dem zugehörigen ContainerDienst bereitgestellt wird. (Geerbt von Component)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject)
Install(IDictionary)	Führt die Installation aus.
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekts. (Geerbt von MarshalByRefObject)
OnAfterInstall(IDictionary)	Löst das AfterInstall-Ereignis aus. (Geerbt von Installer)
OnAfterRollback(IDictionary)	Löst das AfterRollback-Ereignis aus. (Geerbt von Installer)
OnAfterUninstall(IDictionary)	Löst das AfterUninstall-Ereignis aus. (Geerbt von Installer)
OnBeforeInstall(IDictionary)	Löst das BeforeInstall-Ereignis aus. (Geerbt von Installer)
OnBeforeRollback(IDictionary)	Löst das BeforeRollback-Ereignis aus. (Geerbt von Installer)
OnBeforeUninstall(IDictionary)	Löst das BeforeUninstall-Ereignis aus. (Geerbt von Installer)
OnCommitted(IDictionary)	Löst das Committed-Ereignis aus. (Geerbt von Installer)
OnCommitting(IDictionary)	Löst das Committing-Ereignis aus. (Geerbt von Installer)
Rollback(IDictionary)	Stellt den Computer in den Zustand wieder her, in dem er sich vor der Installation befand.
ToString()	Gibt einen String mit dem Namen des Component, falls vorhanden, zurück. Diese Methode sollte nicht außer Kraft gesetzt werden. (Geerbt von Component)
Uninstall(IDictionary)	Entfernt eine Installation.

Ereignisse

Name	Beschreibung
AfterInstall	Tritt ein, nachdem die Install(IDictionary) Methoden aller Installationsprogramme in der Installers Eigenschaft ausgeführt wurden. (Geerbt von Installer)
AfterRollback	Tritt ein, nachdem die Installationen aller Installationsprogramme in der Installers Eigenschaft zurückgesetzt wurden. (Geerbt von Installer)
AfterUninstall	Tritt ein, nachdem alle Installationsprogramme in der Installers Eigenschaft ihre Deinstallationsvorgänge ausgeführt haben. (Geerbt von Installer)
BeforeInstall	Tritt auf, bevor die Install(IDictionary) Methode der einzelnen Installationsprogramme in der Installer-Auflistung ausgeführt wurde. (Geerbt von Installer)
BeforeRollback	Tritt auf, bevor die Installationsprogramme in der Installers Eigenschaft zurückgesetzt werden. (Geerbt von Installer)
BeforeUninstall	Tritt auf, bevor die Installationsprogramme in der Installers Eigenschaft ihre Deinstallationsvorgänge ausführen. (Geerbt von Installer)
Committed	Tritt auf, nachdem alle Installationsprogramme in der Installers Eigenschaft ihre Installationen zugesichert haben. (Geerbt von Installer)
Committing	Tritt auf, bevor die Installationsprogramme in der Installers Eigenschaft ihre Installationen übernehmen. (Geerbt von Installer)
Disposed	Tritt auf, wenn die Komponente durch einen Aufruf der Dispose() Methode verworfen wird. (Geerbt von Component)

Gilt für:

Feedback

War diese Seite hilfreich?