InstallException クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

InstallException クラス

インストールのコミット、ロールバック、またはアンインストールの各フェーズでエラーが発生したときにスローされる例外。

名前空間: System.Configuration.Install
アセンブリ: System.Configuration.Install (system.configuration.install.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public Class InstallException
    Inherits SystemException

Visual Basic (使用法)

Dim instance As InstallException

[SerializableAttribute] 
public class InstallException : SystemException

C++

[SerializableAttribute] 
public ref class InstallException : public
 SystemException

/** @attribute SerializableAttribute() */ 
public class InstallException extends SystemException

JScript

SerializableAttribute 
public class InstallException extends
 SystemException

使用例

InstallException コンストラクタの例と共に、独自のインストーラを持つアセンブリを表示する例を次に示します。インストーラは MyInstaller という名前で、属性 RunInstallerAttribute を持っており、このインストーラがインストーラツール (Installutil.exe) によって起動されることを示しています。インストーラツール (Installutil.exe) は、Commit、Rollback、Install、および Uninstall の各メソッドを呼び出します。Commit のコードは、アセンブリのインストールがコミットされる前に、FileDoesNotExist.txt という名前のファイルが存在すると仮定しています。ファイル FileDoesNotExist.txt が存在しない場合、Commit は、InstallException を発生させます。同じことは、FileDoesNotExist.txt という名前のファイルが存在する場合にだけアンインストールが行われる Uninstall にも当てはまります。それ以外の場合は、InstallException が発生します。Rollback でコード片が実行されます。このコード片の実行は、例外を発生させる可能性があります。例外が発生した場合、その例外はキャッチされ、渡される例外を使用して InstallException を発生させます。

メモ
この例は Installutil.exe を使用して実行します。コマンドプロンプトで次のように入力します。

Installutil InstallException.exe

または

Installutil /u InstallException.exe

Visual Basic

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

<RunInstaller(True)> Public Class
 MyInstaller
   Inherits Installer

   Public Overrides Sub
 Install(savedState As IDictionary)
      MyBase.Install(savedState)
      Console.WriteLine("Install ...")

     ' Commit is called when install goes through successfully.
     ' Rollback is called if there is any error during Install.
     ' Uncommenting the code below will lead to 'RollBack' being called
,
     ' currently 'Commit' shall be called.
     ' throw new IOException();

   End Sub

   Public Overrides Sub
 Commit(savedState As IDictionary)
      MyBase.Commit(savedState)
      Console.WriteLine("Commit ...")
      ' Throw an error if a particular file doesn't exist.
      If Not File.Exists("FileDoesNotExist.txt")
 Then
         Throw New InstallException()
      End If
      ' Perform the final installation if the file exists.
   End Sub

   Public Overrides Sub
 Rollback(savedState As IDictionary)
      MyBase.Rollback(savedState)
      Console.WriteLine("RollBack ...")
      Try
         ' Performing some activity during rollback that raises an 'IOException'.
         Throw New IOException()
      Catch e As Exception
         Throw New InstallException("IOException
 raised", e)
      End Try
   End Sub 'Rollback
    ' Perform the remaining rollback activites if no exception raised.

   Public Overrides Sub
 Uninstall(savedState As IDictionary)
      MyBase.Uninstall(savedState)
      Console.WriteLine("UnInstall ...")
      ' Throw an error if a particular file doesn't exist.
      If Not File.Exists("FileDoesNotExist.txt")
 Then
         Throw New InstallException("The
 file 'FileDoesNotExist'" + " does not exist")
      End If
      ' Perform the uninstall activites if the file exists.
   End Sub

End Class

' An Assembly that has its own installer.
Public Class MyAssembly1
   Public Shared Sub Main()
      Console.WriteLine("This assembly is just an example for
 the Installer")
   End Sub
End Class

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


[RunInstaller(true)]
public class MyInstaller : Installer
{
   public override void Install(IDictionary
 savedState)
   {
      base.Install(savedState);
      Console.WriteLine("Install ...");

      // Commit is called when install goes through successfully.
      // Rollback is called if there is any error during Install.

      // Uncommenting the code below will lead to 'RollBack' being called
,
      // currently 'Commit' shall be called.

      // throw new IOException();
   }

   public override void Commit(IDictionary
 savedState)
   {
      base.Commit(savedState);
      Console.WriteLine("Commit ...");
      // Throw an error if a particular file doesn't exist.
      if(!File.Exists("FileDoesNotExist.txt"))
         throw new InstallException();
      // Perform the final installation if the file exists.
   }

   public override void Rollback(IDictionary
 savedState)
   {
      base.Rollback(savedState);
      Console.WriteLine("RollBack ...");
      try
      {
         // Performing some activity during rollback that raises an
 'IOException'.
         throw new IOException();
      }
      catch(Exception e)
      {
         throw new InstallException("IOException raised",
 e);
      }
      // Perform the remaining rollback activites if no exception raised.
   }

   public override void Uninstall(IDictionary
 savedState)
   {
      base.Uninstall(savedState);
      Console.WriteLine("UnInstall ...");
      // Throw an error if a particular file doesn't exist.
      if(!File.Exists("FileDoesNotExist.txt"))
         throw new InstallException("The file 'FileDoesNotExist'"
 +
            " does not exist");
      // Perform the uninstall activites if the file exists.
   }
}


// An Assembly that has its own installer.
public class MyAssembly1
{
   public static void Main()
   {
      Console.WriteLine("This assembly is just an example for
 the Installer");
   }
}

C++

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

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

[RunInstaller(true)]
ref class MyInstaller: public Installer
{
public:
   virtual void Install( IDictionary^ savedState ) override
   {
      Installer::Install( savedState );
      Console::WriteLine( "Install ..." );
      
      // Commit is called when install goes through successfully.
      // Rollback is called if there is any error during Install.
      // Uncommenting the code below will lead to 'RollBack' being called
,
      // currently 'Commit' shall be called.
      // throw new IOException();
   }


   virtual void Commit( IDictionary^ savedState ) override
   {
      Installer::Commit( savedState );
      Console::WriteLine( "Commit ..." );
      
      // Throw an error if a particular file doesn't exist.
      if (  !File::Exists( "FileDoesNotExist.txt" )
 )
            throw gcnew InstallException;

      
      // Perform the final installation if the file exists.
   }


   virtual void Rollback( IDictionary^ savedState ) override
   {
      Installer::Rollback( savedState );
      Console::WriteLine( "RollBack ..." );
      try
      {
         
         // Performing some activity during rollback that raises an
 'IOException*'.
         throw gcnew IOException;
      }
      catch ( Exception^ e ) 
      {
         throw gcnew InstallException( "IOException* raised",e );
      }

      
      // Perform the remaining rollback activites if no exception raised.
   }


   virtual void Uninstall( IDictionary^ savedState ) override
   {
      Installer::Uninstall( savedState );
      Console::WriteLine( "UnInstall ..." );
      
      // Throw an error if a particular file doesn't exist.
      if (  !File::Exists( "FileDoesNotExist.txt" )
 )
            throw gcnew InstallException( "The file 'FileDoesNotExist'  does
 not exist" );

      
      // Perform the uninstall activites if the file exists.
   }

};

int main()
{
   Console::WriteLine( "This assembly is just an example for
 the Installer" );
}

import System.*;
import System.ComponentModel.*;
import System.Collections.*;
import System.Configuration.Install.*;
import System.IO.*;

/** @attribute RunInstaller(true)
 */
public class MyInstaller extends Installer
{
    public void Install(IDictionary savedState)
    {
        super.Install(savedState);
        Console.WriteLine("Install ...");
    } //Install

    // Commit is called when install goes through successfully.
    // Rollback is called if there is any error during Install.
    // Uncommenting the code below will lead to 'RollBack' being called
,
    // currently 'Commit' shall be called.
    // throw new IOException();
    public void Commit(IDictionary savedState)
 
        throws System.Configuration.Install.InstallException   
    {
        super.Commit(savedState);
        Console.WriteLine("Commit ...");

        // Throw an error if a particular file doesn't exist.
        if (!(File.Exists("FileDoesNotExist.txt")))
 {
            throw new InstallException();
        }
        // Perform the final installation if the file exists.
    } //Commit
    public void Rollback(IDictionary savedState)
 
        throws System.Configuration.Install.InstallException   
    {
        super.Rollback(savedState);
        Console.WriteLine("RollBack ...");
        try {
            // Performing some activity during rollback 
            //that raises an 'IOException'.
            throw new IOException();
        }
        catch (System.Exception e) {
            throw new InstallException("IOException raised",
 e);
        }
        // Perform the remaining rollback activites if no exception
 raised.
    } //Rollback
    public void Uninstall(IDictionary savedState)
 
        throws System.Configuration.Install.InstallException   
    {
        super.Uninstall(savedState);
        Console.WriteLine("UnInstall ...");

        // Throw an error if a particular file doesn't exist.
        if (!(File.Exists("FileDoesNotExist.txt")))
 {
            throw new InstallException("The file 'FileDoesNotExist'"
 
                + " does not exist");
        }
    } //Uninstall
} //MyInstaller
 // Perform the uninstall activites if the file exists.

// An Assembly that has its own installer.
public class MyAssembly1
{
    public static void main(String[]
 args)
    {
        Console.WriteLine("This assembly is just an example for
 the Installer");
    } //main
} //MyAssembly1