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、InstallUninstall の各メソッドの例を次に示します

インストーラ ツール (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 名前空間



英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

すべての辞書の索引

「TransactedInstaller」の関連用語

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

   

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



TransactedInstallerのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

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

©2025 GRAS Group, Inc.RSS