チュートリアル : カスタム動作の作成

[アーティクル]
08/09/2011

次のチュートリアルでは、インストール終了時にユーザーを Web ページへ導く DLL カスタム動作の作成方法について、手順を説明します。カスタム動作を使用すると、インストールの終了後にコードを実行できます。

注意

お使いのマシンで、Visual Studio ユーザーインターフェイスの一部の要素の名前や場所が、次の手順とは異なる場合があります。これらの要素は、使用している Visual Studio のエディションや独自の設定によって決まります。詳細については、「Visual Studio の設定」を参照してください。

カスタム動作を作成するには

[ファイル] メニューの [新しいプロジェクト] をクリックします。
[新しいプロジェクト] ダイアログボックスで、[Windows] をクリックし、[クラスライブラリ] をクリックします。 [プロジェクト名] ボックスに「OpenWeb」と入力します。

新規プロジェクトがソリューションエクスプローラーに追加されます。
[プロジェクト] メニューの [クラスの追加] をクリックし、[新しい項目の追加] ダイアログボックスの [インストーラークラス] をクリックします。既定の名前 Installer1 をそのまま使用し、[追加] をクリックします。
デザインサーフェイスの [ここをクリックするとコードビューに切り替わります] をクリック (またはデザインサーフェイスを右クリックして [コードの表示] をクリック) して、コードビューに切り替えます。

コードエディターで、Installer1 コードファイルのコンストラクターの下に、次のコード (Web ブラウザーを開くコード) を追加します。

<Security.Permissions.SecurityPermission(Security.Permissions.SecurityAction.Demand)>
Public Overrides Sub Install(ByVal stateSaver As System.Collections.IDictionary)
    MyBase.Install(stateSaver)
End Sub

<Security.Permissions.SecurityPermission(Security.Permissions.SecurityAction.Demand)>
Public Overrides Sub Commit(
  ByVal savedState As System.Collections.IDictionary)

    MyBase.Commit(savedState)
    System.Diagnostics.Process.Start("https://www.microsoft.com")
End Sub

<Security.Permissions.SecurityPermission(Security.Permissions.SecurityAction.Demand)>
Public Overrides Sub Rollback(ByVal savedState As System.Collections.IDictionary)
    MyBase.Rollback(savedState)
End Sub

<Security.Permissions.SecurityPermission(Security.Permissions.SecurityAction.Demand)>
Public Overrides Sub Uninstall(ByVal savedState As System.Collections.IDictionary)
    MyBase.Uninstall(savedState)
End Sub

[System.Security.Permissions.SecurityPermission(System.Security.Permissions.SecurityAction.Demand)]
public override void Install(IDictionary stateSaver)
{
    base.Install(stateSaver);
}

[System.Security.Permissions.SecurityPermission(System.Security.Permissions.SecurityAction.Demand)]
public override void Commit(IDictionary savedState)
{
    base.Commit(savedState);
    System.Diagnostics.Process.Start("https://www.microsoft.com");
}

[System.Security.Permissions.SecurityPermission(System.Security.Permissions.SecurityAction.Demand)]
public override void Rollback(IDictionary savedState)
{
    base.Rollback(savedState);
}

[System.Security.Permissions.SecurityPermission(System.Security.Permissions.SecurityAction.Demand)]
public override void Uninstall(IDictionary savedState)
{
    base.Uninstall(savedState);
}

注意

「Public Overrides」と入力し、次に空白を入力すると、IntelliSense によってメソッドとプロパティのリストが表示されます。リストから [Commit] を選択して完全な宣言を取得します。 Install、Rollback、Uninstall の各メソッドについて繰り返します。

ソリューションエクスプローラーで、Class1 コードファイルを右クリックし、これが不要であるため [削除] をクリックします。

配置プロジェクトを追加するには

[ファイル] メニューの [追加] をポイントし、[新しいプロジェクト] をクリックします。
[新しいプロジェクトの追加] ダイアログボックスで、[その他のプロジェクトの種類] ノードを展開し、[セットアップ/配置プロジェクト] を展開して、[Visual Studio インストーラー] をクリックします。次に、[セットアッププロジェクト] をクリックします。 [プロジェクト名] ボックスに「Custom Action Installer」と入力します。

プロジェクトがソリューションエクスプローラーに追加され、ファイルシステムエディターが表示されます。
ファイルシステムエディターの左ペインで [アプリケーションフォルダー] を選択します。 [操作] メニューの [追加] をポイントし、[プロジェクト出力] をクリックします。
[プロジェクト出力グループの追加] ダイアログボックスの [プロジェクト] ボックスの一覧に OpenWeb が表示されます。 [プライマリ出力] を選択します。

アプリケーションフォルダーに [OpenWeb (アクティブ) のプライマリ出力] が表示されます。

カスタム動作を追加するには

ソリューションエクスプローラーで、Custom Action Installer プロジェクトを選択します。 [表示] メニューの [エディター] をポイントし、[カスタム動作] をクリックします。

カスタム動作エディターが表示されます。
カスタム動作エディターで、[確定] ノードを選択します。 [操作] メニューの [カスタム動作の追加] をクリックします。
[プロジェクトから項目を選択] ダイアログボックスで、[アプリケーションフォルダー] をダブルクリックします。 [OpenWeb のプライマリ出力] を選択します。

カスタム動作エディター内で、[確定] ノードの下に [OpenWeb のプライマリ出力] が表示されます。
[プロパティ] ウィンドウで、InstallerClass プロパティに True (既定値) が設定されていることを確認します。
[確定] ノードのときと同じように、カスタム動作エディターで [インストール] ノードを選択し、このノードに [OpenWeb のプライマリ出力] を追加します。
[ビルド] メニューの [Custom Action Installer のビルド] をクリックします。

開発用コンピューターにインストールするには

ソリューションエクスプローラーで、Custom Action Installer プロジェクトを選択します。 [プロジェクト] メニューの [インストール] をクリックします。

インストーラーが実行され、開発用コンピューターに Custom Action Installer がインストールされます。インストールの最後に Internet Explorer が開始され、Microsoft.com Web サイトが表示されます。

注意

インストーラーを実行するには、コンピューター上でインストールを実行する権限が必要です。

他のコンピューターに配置するには

ソリューションエクスプローラーで、セットアッププロジェクトを右クリックし、[エクスプローラーでフォルダーを開く] をクリックします。
プロジェクトの出力に移動し、Custom Action Installer.msi、Setup.exe、およびディレクトリ内の他のファイルとサブディレクトリをすべて別のコンピューターにコピーします。

注意

ネットワークに接続していないコンピューターにインストールするには、ファイルを CD-ROM などの従来のメディアにコピーしてください。
ターゲットコンピューターで、Setup.exe をダブルクリックしてインストーラーを実行します。

インストールの最後に Internet Explorer が開始され、Microsoft.com Web サイトが表示されます。

注意

インストーラーを実行するには、コンピューター上でインストールを実行する権限が必要です。

注意

ターゲットコンピューターに .NET Framework がインストールされていない場合はこの配置によってインストールされますが、このインストールには数分間かかる場合があります。

アプリケーションをアンインストールするには

[コントロールパネル] で [プログラムの追加と削除] をダブルクリックします。
[プログラムの追加と削除] ダイアログボックスの [Custom Action Installer] をクリックし、[削除] をクリックします。

ヒント

開発用コンピューターからアンインストールするには、ソリューションエクスプローラーで Custom Action Installer プロジェクトを開いて選択し、[プロジェクト] メニューの [アンインストール] をクリックします。

参照

その他の技術情報

配置でのカスタム動作の管理