TransactedInstallerとは? わかりやすく解説

TransactedInstaller イベント


パブリック イベントパブリック イベント

  名前 説明
パブリック イベント AfterInstall  Installers プロパティ内のすべてのインストーラの Install メソッドが実行された後で発生します。 ( Installer から継承されます。)
パブリック イベント AfterRollback  Installers プロパティ内のすべてのインストーラによるインストールがロールバックされた後で発生します。 ( Installer から継承されます。)
パブリック イベント AfterUninstall  Installers プロパティ内のすべてのインストーラのアンインストールが実行された後で発生します。 ( Installer から継承されます。)
パブリック イベント BeforeInstall  インストーラ コレクション内の各インストーラの Install メソッドが実行される前に発生します。 ( Installer から継承されます。)
パブリック イベント BeforeRollback  Installers プロパティ内のインストーラによるインストールがロールバックされる前に発生します。 ( Installer から継承されます。)
パブリック イベント BeforeUninstall  Installers プロパティ内のインストーラのアンインストールが実行される前に発生します。 ( Installer から継承されます。)
パブリック イベント Committed  Installers プロパティ内のすべてのインストーラがインストールをコミットした後で発生します。 ( Installer から継承されます。)
パブリック イベント Committing  Installers プロパティ内のインストーラがインストールをコミットする前に発生します。 ( Installer から継承されます。)
パブリック イベント Disposed  コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。 ( Component から継承されます。)
参照参照

関連項目

TransactedInstaller クラス
System.Configuration.Install 名前空間

TransactedInstaller クラス

インストーラによるインストールが正常終了したか、失敗してコンピュータが初期状態のままのいずれであるかを明確にします。

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

Public Class TransactedInstaller
    Inherits Installer
Dim instance As TransactedInstaller
public class TransactedInstaller : Installer
public ref class TransactedInstaller : public
 Installer
public class TransactedInstaller extends Installer
public class TransactedInstaller extends
 Installer
解説解説
使用例使用例

TransactedInstaller クラスの TransactedInstaller、Install、Uninstall の各メソッドの例を次に示します。

インストーラ ツール (Installutil.exe) の実装に類似した実装の例を次に示します。特定のアセンブリの前にオプションを指定して、アセンブリをインストールします。アセンブリに対してオプションが指定されていない場合、直前のアセンブリがリストにある場合は、直前のアセンブリのオプションが使用されます。"/u" オプションまたは "/uninstall" オプションのいずれかを指定した場合、アセンブリはアンインストールされます。"/?" オプションまたは "/help" オプションが指定された場合は、ヘルプ情報がコンソールに表示されます。

Dim options As New ArrayList()
Dim myOption As String
Dim toUnInstall As Boolean
 = False
Dim toPrintHelp As Boolean
 = False
Dim myTransactedInstaller As New
 TransactedInstaller()
Dim myAssemblyInstaller As AssemblyInstaller
Dim myInstallContext As InstallContext

Try
   Dim i As Integer
   For i = 1 To args.Length - 1
      ' Process the arguments.
      If args(i).StartsWith("/")
 Or args(i).StartsWith("-") Then
         myOption = args(i).Substring(1)
         ' Determine whether the option is to 'uninstall' an assembly.
         If String.Compare(myOption, "u",
 True) = 0 Or _
            String.Compare(myOption,"uninstall",
 True) = 0 Then
            toUnInstall = True
            GoTo ContinueFor1
         End If
         ' Determine whether the option is for printing help information.
         If String.Compare(myOption, "?",
 True) = 0 Or _
            String.Compare(myOption, "help",
 True) = 0 Then
            toPrintHelp = True
            GoTo ContinueFor1
         End If
         ' Add the option encountered to the list of all options
         ' encountered for the current assembly.
         options.Add(myOption)
      Else
         ' Determine whether the assembly file exists.
         If Not File.Exists(args(i)) Then
            ' If assembly file doesn't exist then print error.
            Console.WriteLine(ControlChars.Newline + _
                     "Error : {0} - Assembly file doesn't
 exist.", args(i))
            Return
         End If

         ' Create a instance of 'AssemblyInstaller' that installs the
 given assembly.
         myAssemblyInstaller = New AssemblyInstaller(args(i),
 _
                        CType(options.ToArray(GetType(String)),
 String()))
         ' Add the instance of 'AssemblyInstaller' to the 'TransactedInstaller'.
         myTransactedInstaller.Installers.Add(myAssemblyInstaller)
      End If
   ContinueFor1:
   Next i
   ' If user requested help or didn't provide any assemblies to install
   ' then print help message.
   If toPrintHelp Or myTransactedInstaller.Installers.Count
 = 0 Then
      PrintHelpMessage()
      Return
   End If

   ' Create a instance of 'InstallContext' with the options specified.
   myInstallContext = New InstallContext("Install.log",
 _
               CType(options.ToArray(GetType(String)),
 String()))
   myTransactedInstaller.Context = myInstallContext

   ' Install or Uninstall an assembly depending on the option provided.
   If Not toUnInstall Then
      myTransactedInstaller.Install(New Hashtable())
   Else
      myTransactedInstaller.Uninstall(Nothing)
   End If
Catch e As Exception
   Console.WriteLine(ControlChars.Newline + "Exception raised
 : {0}", e.Message)
End Try
ArrayList myOptions = new ArrayList();
String myOption;
bool toUnInstall = false;
bool toPrintHelp = false;
TransactedInstaller myTransactedInstaller = new TransactedInstaller();
AssemblyInstaller myAssemblyInstaller;
InstallContext myInstallContext;

try
{
   for(int i = 0; i < args.Length; i++)
   {
      // Process the arguments.
      if(args[i].StartsWith("/") || args[i].StartsWith("-"))
      {
         myOption = args[i].Substring(1);
         // Determine whether the option is to 'uninstall' an assembly.
         if(String.Compare(myOption, "u", true)
 == 0 ||
            String.Compare(myOption, "uninstall", true)
 == 0)
         {
            toUnInstall = true;
            continue;
         }
         // Determine whether the option is for printing help information.
         if(String.Compare(myOption, "?", true)
 == 0 ||
            String.Compare(myOption, "help", true) ==
 0)
         {
            toPrintHelp = true;
            continue;
         }
         // Add the option encountered to the list of all options
         // encountered for the current assembly.
         myOptions.Add(myOption);
      }
      else
      {
         // Determine whether the assembly file exists.
         if(!File.Exists(args[i]))
         {
            // If assembly file doesn't exist then print error.
            Console.WriteLine("\nError : {0} - Assembly file doesn't exist."
,
               args[i]);
            return;
         }
      
         // Create a instance of 'AssemblyInstaller' that installs the
 given assembly.
         myAssemblyInstaller = 
            new AssemblyInstaller(args[i], 
            (string[]) myOptions.ToArray(typeof(string)));
         // Add the instance of 'AssemblyInstaller' to the 'TransactedInstaller'.
  
         myTransactedInstaller.Installers.Add(myAssemblyInstaller);
      }
   }
   // If user requested help or didn't provide any assemblies to install
   // then print help message.
   if(toPrintHelp || myTransactedInstaller.Installers.Count ==
 0)
   {
      PrintHelpMessage();
      return;
   }

   // Create a instance of 'InstallContext' with the options specified.
   myInstallContext = 
      new InstallContext("Install.log", 
      (string[]) myOptions.ToArray(typeof(string)));
   myTransactedInstaller.Context = myInstallContext;

   // Install or Uninstall an assembly depending on the option provided.
   if(!toUnInstall)
      myTransactedInstaller.Install(new Hashtable());
   else
      myTransactedInstaller.Uninstall(null);
}
catch(Exception e)
{
   Console.WriteLine("\nException raised : {0}", e.Message);
}  
array<String^>^ args = Environment::GetCommandLineArgs();
ArrayList^ myOptions = gcnew ArrayList;
String^ myOption;
bool toUnInstall = false;
bool toPrintHelp = false;
TransactedInstaller^ myTransactedInstaller = gcnew TransactedInstaller;
AssemblyInstaller^ myAssemblyInstaller;
InstallContext^ myInstallContext;

try
{
   for ( int i = 1; i < args->Length;
 i++ )
   {
      // Process the arguments.
      if ( args[ i ]->StartsWith( "/" ) || args[
 i ]->StartsWith( "-" ) )
      {
         myOption = args[ i ]->Substring( 1 );
         // Determine whether the option is to 'uninstall' an assembly.
         if ( String::Compare( myOption, "u", true
 ) == 0 ||
            String::Compare( myOption, "uninstall", true
 ) == 0 )
         {
            toUnInstall = true;
            continue;
         }
         // Determine whether the option is for printing help information.
         if ( String::Compare( myOption, "?", true
 ) == 0 ||
            String::Compare( myOption, "help", true
 ) == 0 )
         {
            toPrintHelp = true;
            continue;
         }
         // Add the option encountered to the list of all options
         // encountered for the current assembly.
         myOptions->Add( myOption );
      }
      else
      {
         // Determine whether the assembly file exists.
         if (  !File::Exists( args[ i ] ) )
         {
            // If assembly file doesn't exist then print error.
            Console::WriteLine( "\nError : {0} - Assembly file doesn't exist."
,
               args[ i ] );
            return 0;
         }
         
         // Create a instance of 'AssemblyInstaller' that installs the
 given assembly.
         myAssemblyInstaller =
            gcnew AssemblyInstaller( args[ i ],
               (array<String^>^)( myOptions->ToArray( String::typeid ) )
 );
         // Add the instance of 'AssemblyInstaller' to the 'TransactedInstaller'.
         myTransactedInstaller->Installers->Add( myAssemblyInstaller );
      }
   }
   
   // If user requested help or didn't provide any assemblies to install
   // then print help message.
   if ( toPrintHelp || myTransactedInstaller->Installers->Count
 == 0 )
   {
      PrintHelpMessage();
      return 0;
   }
   
   // Create a instance of 'InstallContext' with the options specified.
   myInstallContext =
      gcnew InstallContext( "Install.log",
         (array<String^>^)( myOptions->ToArray( String::typeid ) ) );
   myTransactedInstaller->Context = myInstallContext;
   
   // Install or Uninstall an assembly depending on the option provided.
   if (  !toUnInstall )
   {
      myTransactedInstaller->Install( gcnew Hashtable );
   }
   else
   {
      myTransactedInstaller->Uninstall( nullptr );
   }
}
catch ( Exception^ e ) 
{
   Console::WriteLine( "\nException raised : {0}", e->Message );
}
ArrayList myOptions = new ArrayList();
String myOption;
boolean toUnInstall = false;
boolean toPrintHelp = false;
TransactedInstaller myTransactedInstaller = new TransactedInstaller();
AssemblyInstaller myAssemblyInstaller;
InstallContext myInstallContext;

try {
    for (int i = 0; i < args.length; i++)
 {
        // Process the arguments.
        if (args[i].StartsWith("/") || args[i].StartsWith("-"))
 {
            myOption = args[i].Substring(1);
            // Determine whether the option is to 'uninstall' an
            // assembly.
            if (String.Compare(myOption, "u", true)
 == 0
                || String.Compare(myOption, "uninstall", true)
 == 0) {
                toUnInstall = true;
                continue;
            }
            // Determine whether the option is for printing help
            // information.
            if (String.Compare(myOption, "?", true)
 == 0
                || String.Compare(myOption, "help", true)
 == 0) {
                toPrintHelp = true;
                continue;
            }
            // Add the option encountered to the list of all options
            // encountered for the current assembly.
            myOptions.Add(myOption);
        }
        else {
            // Determine whether the assembly file exists.
            if (!(File.Exists(args[i]))) {
                // If assembly file doesn't exist then print error.
                Console.WriteLine("\nError : {0} - Assembly file"
                    + " doesn't exist.", args[i]);
                return;
            }
            // Create a instance of 'AssemblyInstaller' that installs
            // the given assembly.
            myAssemblyInstaller = new AssemblyInstaller(args[i]
,
                ((String[])(myOptions.ToArray(String.class.ToType()))));
            // Add the instance of 'AssemblyInstaller' to the
            // 'TransactedInstaller'.  
            myTransactedInstaller.get_Installers().
                Add(myAssemblyInstaller);
        }
    }
    // If user requested help or didn't provide any assemblies to install
    // then print help message.
    if (toPrintHelp
        || myTransactedInstaller.get_Installers().get_Count() == 0) {
        PrintHelpMessage();
        return;
    }
    // Create a instance of 'InstallContext' with the options specified.
    myInstallContext = new InstallContext("Install.log"
,
        (String[])myOptions.ToArray(String.class.ToType()));
    myTransactedInstaller.set_Context(myInstallContext);
    // Install or Uninstall an assembly depending on the option provided.
    if (!(toUnInstall)) {
        myTransactedInstaller.Install(new Hashtable());
    }
    else {
        myTransactedInstaller.Uninstall(null);
    }
}
catch (System.Exception e) {
    Console.WriteLine("\nException raised : {0}", e.get_Message());
}
継承階層継承階層
System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Configuration.Install.Installer
        System.Configuration.Install.TransactedInstaller
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
TransactedInstaller メンバ
System.Configuration.Install 名前空間

TransactedInstaller コンストラクタ


TransactedInstaller プロパティ


パブリック プロパティパブリック プロパティ

プロテクト プロパティプロテクト プロパティ
参照参照

関連項目

TransactedInstaller クラス
System.Configuration.Install 名前空間

TransactedInstaller メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Commit  派生クラスによってオーバーライドされた場合、インストール トランザクションを完了します。 ( Installer から継承されます。)
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド Dispose  オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド Install オーバーライドされます。 インストールを実行します。
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド Rollback  派生クラスによってオーバーライドされた場合、インストール前のコンピュータの状態を復元します。 ( Installer から継承されます。)
パブリック メソッド ToString  Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 ( Component から継承されます。)
パブリック メソッド Uninstall オーバーライドされます。 インストールした内容を削除します。
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Dispose  オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
プロテクト メソッド Finalize  Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。)
プロテクト メソッド GetService  Component またはその Container で提供されるサービスを表すオブジェクトを返します。 ( Component から継承されます。)
プロテクト メソッド MemberwiseClone  オーバーロードされます。 ( MarshalByRefObject から継承されます。)
プロテクト メソッド OnAfterInstall  AfterInstall イベントを発生させます。 ( Installer から継承されます。)
プロテクト メソッド OnAfterRollback  AfterRollback イベントを発生させます。 ( Installer から継承されます。)
プロテクト メソッド OnAfterUninstall  AfterUninstall イベントを発生させます。 ( Installer から継承されます。)
プロテクト メソッド OnBeforeInstall  BeforeInstall イベントを発生させます。 ( Installer から継承されます。)
プロテクト メソッド OnBeforeRollback  BeforeRollback イベントを発生させます。 ( Installer から継承されます。)
プロテクト メソッド OnBeforeUninstall  BeforeUninstall イベントを発生させます。 ( Installer から継承されます。)
プロテクト メソッド OnCommitted  Committed イベントを発生させます。 ( Installer から継承されます。)
プロテクト メソッド OnCommitting  Committing イベントを発生させます。 ( Installer から継承されます。)
参照参照

関連項目

TransactedInstaller クラス
System.Configuration.Install 名前空間

TransactedInstaller メンバ

インストーラによるインストールが正常終了したか、失敗してコンピュータが初期状態のままのいずれであるかを明確にします。

TransactedInstaller データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド TransactedInstaller TransactedInstaller クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
プロテクト プロパティプロテクト プロパティ
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Commit  派生クラスによってオーバーライドされた場合、インストール トランザクションを完了します。 (Installer から継承されます。)
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
パブリック メソッド Dispose  オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド Install オーバーライドされます。 インストールを実行します。
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド Rollback  派生クラスによってオーバーライドされた場合、インストール前のコンピュータの状態を復元します。 (Installer から継承されます。)
パブリック メソッド ToString  Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 (Component から継承されます。)
パブリック メソッド Uninstall オーバーライドされます。 インストールした内容を削除します。
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Dispose  オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
プロテクト メソッド Finalize  Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。)
プロテクト メソッド GetService  Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (Component から継承されます。)
プロテクト メソッド MemberwiseClone  オーバーロードされます。 ( MarshalByRefObject から継承されます。)
プロテクト メソッド OnAfterInstall  AfterInstall イベントを発生させます。 (Installer から継承されます。)
プロテクト メソッド OnAfterRollback  AfterRollback イベントを発生させます。 (Installer から継承されます。)
プロテクト メソッド OnAfterUninstall  AfterUninstall イベントを発生させます。 (Installer から継承されます。)
プロテクト メソッド OnBeforeInstall  BeforeInstall イベントを発生させます。 (Installer から継承されます。)
プロテクト メソッド OnBeforeRollback  BeforeRollback イベントを発生させます。 (Installer から継承されます。)
プロテクト メソッド OnBeforeUninstall  BeforeUninstall イベントを発生させます。 (Installer から継承されます。)
プロテクト メソッド OnCommitted  Committed イベントを発生させます。 (Installer から継承されます。)
プロテクト メソッド OnCommitting  Committing イベントを発生させます。 (Installer から継承されます。)
パブリック イベントパブリック イベント
  名前 説明
パブリック イベント AfterInstall  Installers プロパティ内のすべてのインストーラの Install メソッドが実行された後で発生します。(Installer から継承されます。)
パブリック イベント AfterRollback  Installers プロパティ内のすべてのインストーラによるインストールがロールバックされた後で発生します。(Installer から継承されます。)
パブリック イベント AfterUninstall  Installers プロパティ内のすべてのインストーラのアンインストールが実行された後で発生します。(Installer から継承されます。)
パブリック イベント BeforeInstall  インストーラ コレクション内の各インストーラの Install メソッドが実行される前に発生します。(Installer から継承されます。)
パブリック イベント BeforeRollback  Installers プロパティ内のインストーラによるインストールがロールバックされる前に発生します。(Installer から継承されます。)
パブリック イベント BeforeUninstall  Installers プロパティ内のインストーラのアンインストールが実行される前に発生します。(Installer から継承されます。)
パブリック イベント Committed  Installers プロパティ内のすべてのインストーラがインストールをコミットした後で発生します。(Installer から継承されます。)
パブリック イベント Committing  Installers プロパティ内のインストーラがインストールをコミットする前に発生します。(Installer から継承されます。)
パブリック イベント Disposed  コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。(Component から継承されます。)
参照参照

関連項目

TransactedInstaller クラス
System.Configuration.Install 名前空間



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「TransactedInstaller」の関連用語

TransactedInstallerのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



TransactedInstallerのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS