ServiceProcessInstaller.Install メソッド

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

ServiceProcessInstaller.Install メソッド

サービス アプリケーション情報をレジストリに書き込みます。このメソッドは、セットアップ ツールで使用されます。セットアップ ツールは適切なメソッドを自動的に呼び出します。

名前空間: System.ServiceProcess
アセンブリ: System.ServiceProcess (system.serviceprocess.dll 内)
構文

Visual Basic (宣言)

Public Overrides Sub Install
 ( _
    stateSaver As IDictionary _
)

Visual Basic (使用法)

Dim instance As ServiceProcessInstaller
Dim stateSaver As IDictionary

instance.Install(stateSaver)

C#

public override void Install (
    IDictionary stateSaver
)

C++

public:
virtual void Install (
    IDictionary^ stateSaver
) override

J#

public void Install (
    IDictionary stateSaver
)

JScript

public override function Install (
    stateSaver : IDictionary
)

パラメータ

stateSaver

インストールに関連付けられているコンテキスト情報を格納する IDictionary。

例外

例外の種類	条件
ArgumentException	stateSaver が null 参照 (Visual Basic では Nothing) です。

解説

通常、コード内の ServiceProcessInstaller ではこのメソッドを呼び出しません。このメソッドを呼び出すのは、一般的にインストール ユーティリティだけです。インストール ユーティリティは、インストール プロセス中に ServiceProcessInstaller.Install メソッドを自動的に呼び出します。必要に応じて、インストール済みのすべてのコンポーネントで Rollback を呼び出すことによって、エラーを回復します。このメソッドは、基本クラスの Installer.Install メソッドにインストールを渡します。

通常、コード内の ServiceInstaller では、これらのメソッドを呼び出しません。これらのメソッドを呼び出すのは、一般にはインストール ユーティリティだけです。インストール ユーティリティは、インストール プロセス中に、ServiceProcessInstaller.Install メソッドと ServiceInstaller.Install メソッドを自動的に呼び出します。必要に応じて、インストール済みのすべてのコンポーネントで Rollback (または ServiceInstaller.Rollback) を呼び出すことによって、エラーを回復します。

アプリケーションのインストール ルーチンは、既にインストールされているコンポーネントに関する情報を、プロジェクト インストーラの Installer.Context を使用して自動的に維持します。この状態情報は、Install に stateSaver パラメータとして渡され、ServiceProcessInstaller インスタンスとして継続的に更新されます。各 ServiceInstaller インスタンスは、ユーティリティでインストールされます。通常、コードではこの状態情報を明示的に変更する必要はありません。

Install は、基本クラスのメソッドによって、または BeforeInstall イベント ハンドラや AfterInstall イベント ハンドラによってスローされた例外を、呼び出す側のメソッドに渡します。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ServiceProcessInstaller クラス
ServiceProcessInstaller メンバ
System.ServiceProcess 名前空間
Rollback
Installer.Commit
Uninstall