Installer Classe

Definizione

public ref class Installer : System::ComponentModel::Component

public class Installer : System.ComponentModel.Component

type Installer = class
    inherit Component

Public Class Installer
Inherits Component

Ereditarietà

Object

MarshalByRefObject

Component

Installer

Derivato

System.Configuration.Install.AssemblyInstaller

System.Configuration.Install.ComponentInstaller

System.Configuration.Install.TransactedInstaller

System.Management.Instrumentation.DefaultManagementInstaller

System.Management.Instrumentation.DefaultManagementProjectInstaller

Altro…

Esempio

Nell'esempio seguente viene illustrato l'uso della Installer classe . Crea una classe che eredita da Installer. Quando Commit sta per essere completato, Committing si verifica l'evento e viene visualizzato un messaggio. Per usare la Installer classe , è necessario fare riferimento all'assembly System.Configuration.Install nel progetto.

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

using namespace System;
using namespace System::Collections;
using namespace System::ComponentModel;
using namespace System::Configuration::Install;

// Set 'RunInstaller' attribute to true.

[RunInstaller(true)]
ref class MyInstallerClass: public Installer
{
private:

   // Event handler for 'Committing' event.
   void MyInstaller_Committing( Object^ sender, InstallEventArgs^ e )
   {
      Console::WriteLine( "" );
      Console::WriteLine( "Committing Event occurred." );
      Console::WriteLine( "" );
   }


   // Event handler for 'Committed' event.
   void MyInstaller_Committed( Object^ sender, InstallEventArgs^ e )
   {
      Console::WriteLine( "" );
      Console::WriteLine( "Committed Event occurred." );
      Console::WriteLine( "" );
   }


public:
   MyInstallerClass()
   {
      
      // Attach the 'Committed' event.
      this->Committed += gcnew InstallEventHandler( this, &MyInstallerClass::MyInstaller_Committed );
      
      // Attach the 'Committing' event.
      this->Committing += gcnew InstallEventHandler( this, &MyInstallerClass::MyInstaller_Committing );
   }


   // Override the 'Install' method.
   virtual void Install( IDictionary^ savedState ) override
   {
      Installer::Install( savedState );
   }


   // Override the 'Commit' method.
   virtual void Commit( IDictionary^ savedState ) override
   {
      Installer::Commit( savedState );
   }


   // Override the 'Rollback' method.
   virtual void Rollback( IDictionary^ savedState ) override
   {
      Installer::Rollback( savedState );
   }

};

int main()
{
   Console::WriteLine( "Usage : installutil.exe Installer.exe " );
}

using System;
using System.Collections;
using System.ComponentModel;
using System.Configuration.Install;

// Set 'RunInstaller' attribute to true.
[RunInstaller(true)]
public class MyInstallerClass: Installer
{
   public MyInstallerClass() :base()
   {
      // Attach the 'Committed' event.
      this.Committed += new InstallEventHandler(MyInstaller_Committed);
      // Attach the 'Committing' event.
      this.Committing += new InstallEventHandler(MyInstaller_Committing);
   }
   // Event handler for 'Committing' event.
   private void MyInstaller_Committing(object sender, InstallEventArgs e)
   {
      Console.WriteLine("");
      Console.WriteLine("Committing Event occurred.");
      Console.WriteLine("");
   }
   // Event handler for 'Committed' event.
   private void MyInstaller_Committed(object sender, InstallEventArgs e)
   {
      Console.WriteLine("");
      Console.WriteLine("Committed Event occurred.");
      Console.WriteLine("");
   }
   // Override the 'Install' method.
   public override void Install(IDictionary savedState)
   {
      base.Install(savedState);
   }
   // Override the 'Commit' method.
   public override void Commit(IDictionary savedState)
   {
      base.Commit(savedState);
   }
   // Override the 'Rollback' method.
   public override void Rollback(IDictionary savedState)
   {
      base.Rollback(savedState);
   }
   public static void Main()
   {
      Console.WriteLine("Usage : installutil.exe Installer.exe ");
   }
}

Imports System.Collections
Imports System.ComponentModel
Imports System.Configuration.Install

' Set 'RunInstaller' attribute to true.
<RunInstaller(True)> _
Public Class MyInstallerClass
   Inherits Installer

   Public Sub New()
       MyBase.New()
      ' Attach the 'Committed' event.
      AddHandler Me.Committed, AddressOf MyInstaller_Committed
      ' Attach the 'Committing' event.
      AddHandler Me.Committing, AddressOf MyInstaller_Committing
   End Sub

   ' Event handler for 'Committing' event.
   Private Sub MyInstaller_Committing(ByVal sender As Object, _
                                      ByVal e As InstallEventArgs)
      Console.WriteLine("")
      Console.WriteLine("Committing Event occurred.")
      Console.WriteLine("")
   End Sub

   ' Event handler for 'Committed' event.
   Private Sub MyInstaller_Committed(ByVal sender As Object, _
                                     ByVal e As InstallEventArgs)
      Console.WriteLine("")
      Console.WriteLine("Committed Event occurred.")
      Console.WriteLine("")
   End Sub

   ' Override the 'Install' method.
   Public Overrides Sub Install(ByVal savedState As IDictionary)
      MyBase.Install(savedState)
   End Sub

   ' Override the 'Commit' method.
   Public Overrides Sub Commit(ByVal savedState As IDictionary)
      MyBase.Commit(savedState)
   End Sub

   ' Override the 'Rollback' method.
   Public Overrides Sub Rollback(ByVal savedState As IDictionary)
      MyBase.Rollback(savedState)
   End Sub
   Public Shared Sub Main()
      Console.WriteLine("Usage : installutil.exe Installer.exe ")
   End Sub
End Class

Commenti

Questa è la classe di base per tutti i programmi di installazione personalizzati in .NET Framework. I programmi di installazione sono componenti che consentono di installare applicazioni in un computer.

Per usare :Installer

• Ereditare la Installer classe .

• Eseguire l'override dei Installmetodi , Commit, Rollbacke Uninstall .

• Aggiungere alla RunInstallerAttribute classe derivata e impostarla su true.

• Inserire la classe derivata nell'assembly con l'applicazione da installare.

• Richiamare i programmi di installazione. Ad esempio, usare il InstallUtil.exe per richiamare i programmi di installazione.

La Installers proprietà contiene una raccolta di programmi di installazione. Se questa istanza di fa parte di una raccolta del programma di Installer installazione, la Parent proprietà viene impostata sull'istanza Installer che contiene la raccolta. Per un esempio dell'uso della Installers raccolta, vedere la AssemblyInstaller classe .

I Installmetodi , Commit, Rollbacke Uninstall della Installer classe passano attraverso la raccolta di programmi di installazione archiviati nella Installers proprietà e richiama il metodo corrispondente di ogni programma di installazione.

I Installmetodi , Commit, Rollbacke Uninstall non vengono sempre chiamati nella stessa Installer istanza. Ad esempio, è possibile usare un'istanza Installer durante l'installazione e il commit di un'applicazione e quindi il riferimento a tale istanza viene rilasciato. Successivamente, la disinstallazione dell'applicazione crea un riferimento a una nuova Installer istanza, ovvero il Uninstall metodo viene chiamato da un'istanza diversa di Installer. Per questo motivo, nella classe derivata non salvare lo stato di un computer in un programma di installazione. Usare invece un oggetto IDictionary che viene mantenuto tra le chiamate e passato ai Installmetodi , Commit, Rollbacke Uninstall .

Due situazioni illustrano la necessità di salvare le informazioni nel risparmio IDictionarydi stato . In primo luogo, si supponga che il programma di installazione imposti una chiave del Registro di sistema. Deve salvare il valore originale della chiave in IDictionary. Se viene eseguito il rollback dell'installazione, è possibile ripristinare il valore originale. In secondo luogo, si supponga che il programma di installazione sostituisca un file esistente. Salvare il file esistente in una directory temporanea e il percorso del nuovo percorso del file in IDictionary. Se viene eseguito il rollback dell'installazione, il file più recente viene eliminato e sostituito dall'originale dal percorso temporaneo.

La Installer.Context proprietà contiene informazioni sull'installazione. Ad esempio, informazioni sul percorso del file di log per l'installazione, sul percorso del file per salvare le informazioni richieste dal Uninstall metodo e sulla riga di comando immessa quando è stato eseguito l'eseguibile di installazione.

Costruttori

Proprietà

Metodi

Eventi

Si applica a

Vedi anche

• AssemblyInstaller
• ComponentInstaller
• InstallerCollection
• TransactedInstaller
• Installutil.exe (strumento di installazione)