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 内)
構文
.NET Framework のセキュリティ
プラットフォーム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のページへのリンク