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 (system.configuration.install.dll 内)



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.MarshalByRefObject
System.ComponentModel.Component
System.Configuration.Install.Installer
System.Configuration.Install.TransactedInstaller


Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


TransactedInstaller コンストラクタ
アセンブリ: System.Configuration.Install (system.configuration.install.dll 内)



Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


TransactedInstaller プロパティ

名前 | 説明 | |
---|---|---|
![]() | Container | Component を格納している IContainer を取得します。 ( Component から継承されます。) |
![]() | Context | 現在のインストールに関する情報を取得または設定します。 ( Installer から継承されます。) |
![]() | HelpText | インストーラ コレクション内のすべてのインストーラに関するヘルプ テキストを取得します。 ( Installer から継承されます。) |
![]() | Installers | インストーラが格納しているインストーラのコレクションを取得します。 ( Installer から継承されます。) |
![]() | Parent | インストーラが属しているコレクションを格納しているインストーラを取得または設定します。 ( Installer から継承されます。) |
![]() | Site | Component の ISite を取得または設定します。 ( Component から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | CanRaiseEvents | コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 ( Component から継承されます。) |
![]() | DesignMode | Component が現在デザイン モードかどうかを示す値を取得します。 ( Component から継承されます。) |
![]() | Events | Component に結び付けられているイベント ハンドラのリストを取得します。 ( Component から継承されます。) |

TransactedInstaller メソッド


名前 | 説明 | |
---|---|---|
![]() | 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 メンバ
インストーラによるインストールが正常終了したか、失敗してコンピュータが初期状態のままのいずれであるかを明確にします。
TransactedInstaller データ型で公開されるメンバを以下の表に示します。


名前 | 説明 | |
---|---|---|
![]() | Container | Component を格納している IContainer を取得します。(Component から継承されます。) |
![]() | Context | 現在のインストールに関する情報を取得または設定します。(Installer から継承されます。) |
![]() | HelpText | インストーラ コレクション内のすべてのインストーラに関するヘルプ テキストを取得します。(Installer から継承されます。) |
![]() | Installers | インストーラが格納しているインストーラのコレクションを取得します。(Installer から継承されます。) |
![]() | Parent | インストーラが属しているコレクションを格納しているインストーラを取得または設定します。(Installer から継承されます。) |
![]() | Site | Component の ISite を取得または設定します。(Component から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | CanRaiseEvents | コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。) |
![]() | DesignMode | Component が現在デザイン モードかどうかを示す値を取得します。(Component から継承されます。) |
![]() | Events | Component に結び付けられているイベント ハンドラのリストを取得します。(Component から継承されます。) |


名前 | 説明 | |
---|---|---|
![]() | 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のページへのリンク