Installer クラス

定義

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

public class Installer : System.ComponentModel.Component

type Installer = class
    inherit Component

Public Class Installer
Inherits Component

継承

Object

MarshalByRefObject

Component

Installer

派生

System.Configuration.Install.AssemblyInstaller

System.Configuration.Install.ComponentInstaller

System.Configuration.Install.TransactedInstaller

System.Management.Instrumentation.DefaultManagementInstaller

System.Management.Instrumentation.DefaultManagementProjectInstaller

その他…

例

次の例では、 クラスの使用方法を Installer 示します。 から Installer継承するクラスが作成されます。 Commitが完了すると、Committingイベントが発生し、メッセージが表示されます。 クラスを Installer 使用するには、プロジェクトで System.Configuration.Install アセンブリを参照する必要があります。

#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

注釈

これは、すべての.NET Framework のカスタムインストーラーの基底クラスです。 インストーラーは、コンピューターにアプリケーションをインストールするコンポーネントです。

Installerを使用するには、 次の手順を実行する必要があります。

• Installerクラスを継承します。

• Installメソッド、Commitメソッド、Rollbackメソッド、Uninstallメソッドをすべてオーバーライドします。

• 派生クラスにRunInstallerAttribute属性をtrueで追加します。

• 派生クラスおよびインストールするアプリケーションをアセンブリに配置します。

• インストーラーを起動します。 たとえば、InstallUtil.exe を使用してインストーラーを呼び出します。

Installersプロパティは、インストーラーのコレクションを格納します。 このInstallerのインスタンスがインストーラーコレクションの一部である場合、Parentプロパティをコレクションを含むInstallerインスタンスに設定します。 Installersコレクションの使用例については、AssemblyInstallerクラスを参照してください。

クラスの 、、、および Uninstall メソッドはInstall、 プロパティに格納されているインストーラーのコレクションをInstallers通過し、各インストーラーの対応するメソッドを呼び出します。 RollbackCommitInstaller

、Install、Rollback、および Uninstall の各メソッドは、常に同じInstallerインスタンスで呼び出されるとCommitは限りません。 たとえば、アプリケーションのインストールとコミット中に 1 つの Installer インスタンスが使用され、そのインスタンスへの参照が解放される場合があります。 後でアプリケーションをアンインストールすると、新しい Installer インスタンスへの参照が作成されます。つまり Uninstall 、 メソッドは の別の Installerインスタンスによって呼び出されます。 このため、派生クラスでは、コンピューターの状態をインストーラーに保存しないでください。 代わりに、呼び出し間で保持され、、Commit、、および Uninstall メソッドに渡される を使用IDictionaryしますInstallRollback。

2 つの状況は、状態セーバー に情報を保存する必要がある場合を示しています IDictionary。 まず、インストーラーによってレジストリ キーが設定されたとします。 キーの元の値を に保存する IDictionary必要があります。 インストールがロールバックされた場合は、元の値を復元できます。 次に、インストーラーが既存のファイルを置き換えたとします。 既存のファイルを一時ディレクトリに保存し、 内のファイルの新しい場所の場所を IDictionary保存します。 インストールがロールバックされると、新しいファイルが削除され、一時的な場所から元のファイルに置き換えられます。

Installer.Contextプロパティには、インストールに関する情報が含まれています。 たとえば、インストールのログ ファイルの場所、メソッドで Uninstall 必要な情報を保存するファイルの場所、インストール実行可能ファイルの実行時に入力されたコマンド ラインに関する情報などです。

コンストラクター

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• AssemblyInstaller
• ComponentInstaller
• InstallerCollection
• TransactedInstaller
• Installutil.exe (インストーラー ツール)