次の方法で共有


方法 : プロジェクト テンプレートを組み合わせたウィザードを使用する

更新 : 2007 年 11 月

Visual Studio には、IWizard インターフェイスが用意されています。このインターフェイスを実装すると、ユーザーがテンプレートからプロジェクトを作成する際にカスタム コードを実行できるようになります。

プロジェクト テンプレートのカスタマイズを使用すると、次の操作を実行できます。

  • ユーザー入力を収集してテンプレートをパラメータ化するカスタム UI を表示できます。

  • テンプレートで使用するパラメータ値を追加できます。

  • テンプレートに他のファイルを追加できます。

  • Visual Studio オートメーション オブジェクト モデルによって許可されたアクションを実際にプロジェクトで実行できます。

IWizard インターフェイス メソッドは、プロジェクトの作成中にさまざまな時点で呼び出されます。プロジェクトの作成は、ユーザーが [新しいプロジェクト] ダイアログ ボックスの [OK] をクリックすると同時に開始されます。インターフェイスの各メソッドには、そのメソッドが呼び出される時点を表す名前が付けられます。たとえば、Visual Studio は、プロジェクトの作成の開始直後に RunStarted を呼び出します。この時点が、ユーザー入力を収集するためのカスタム コードの記述に適した場所になります。

カスタム ウィザード用に記述するコードのほとんどでは、DTE オブジェクトを使用します。このオブジェクトは、プロジェクトをカスタマイズするための、Visual Studio オートメーション オブジェクト モデルの主要なオブジェクトです。オートメーション オブジェクト モデルの詳細については、「Visual Studio 環境の拡張」および「オートメーションと機能拡張のリファレンス」を参照してください。

カスタム テンプレート ウィザードの作成

このトピックでは、プロジェクトを作成する前に Windows フォームを開くカスタム ウィザードを作成する方法を紹介します。このフォームを使用すると、ユーザーは、プロジェクトの作成時にソース コードに後から追加されるカスタム パラメータ値を追加できます。主な手順を次に示し、各手順の詳細について説明します。

カスタム テンプレート ウィザードを作成するには

  1. IWizard インターフェイスを実装するアセンブリを作成します。

  2. アセンブリをグローバル アセンブリ キャッシュにインストールします。

  3. プロジェクトを作成し、テンプレートのエクスポート ウィザードを使用して、そのプロジェクトからテンプレートを作成します。

  4. テンプレートを変更します。ここでは、.vstemplate ファイルに WizardExtension 要素を追加し、IWizard を実装するアセンブリにテンプレートをリンクします。

  5. カスタム ウィザードを使用し、新しいプロジェクトを作成します。

IWizard の実装

このプロセスでは、最初に、IWizard を実装するアセンブリを作成します。このアセンブリは、RunStarted メソッドを使用し、ユーザーがカスタム パラメータ値を追加できる Windows フォームを表示します。このパラメータ値は、プロジェクトの作成時に使用されます。

メモ :

この例では、IWizard の実装に Visual C# を使用していますが、Visual J# または Visual Basic を使用することもできます。

IWizard を実装するには

  1. 新しいクラス ライブラリ プロジェクトを作成します。

  2. IWizard インターフェイスを実装するクラスを作成します。完全に実装された IWizard インターフェイスの Visual C# の例については、後述のコードを参照してください。

この例には、2 つのコード ファイルが含まれています。1 つは、IWizardImplementation という、IWizard インターフェイスを実装するクラスで、もう 1 つは、UserInputForm という、ユーザー入力用の Windows フォームです。

IWizardImplementation クラス

IWizardImplementation クラスには、IWizard のすべてのメンバに対するメソッドの実装が含まれています。この例では、RunStarted メソッドだけがタスクを実行します。他のすべてのメソッドは、何もしないか、true を返します。

RunStarted メソッドは、次の 4 つのパラメータを受け取ります。

  • Object パラメータ。プロジェクトをカスタマイズできるように、ルートの _DTE オブジェクトにキャストできます。

  • Dictionary<TKey, TValue> パラメータ。テンプレートで定義済みのすべてのパラメータのコレクションが含まれます。テンプレート パラメータの詳細については、「テンプレート名」を参照してください。

  • WizardRunKind パラメータ。使用されているテンプレートの種類に関する情報が含まれます。

  • Object 配列。Visual Studio によってウィザードに渡される一連のパラメータが格納されます。

この例では、ユーザー入力フォームから Dictionary<TKey, TValue> パラメータにパラメータ値を追加します。プロジェクト内の $custommessage$ パラメータのすべてのインスタンスは、ユーザーが入力したテキストと置き換えられます。

using System;
using System.Collections.Generic;
using Microsoft.VisualStudio.TemplateWizard;
using System.Windows.Forms;
using EnvDTE;

namespace CustomWizard
{
    public class IWizardImplementation:IWizard
    {
        private UserInputForm inputForm;
        private string customMessage;

        // This method is called before opening any item that 
        // has the OpenInEditor attribute.
        public void BeforeOpeningFile(ProjectItem projectItem)
        {
        }

        public void ProjectFinishedGenerating(Project project)
        {
        }
        
        // This method is only called for item templates,
        // not for project templates.
        public void ProjectItemFinishedGenerating(ProjectItem 
            projectItem)
        {
        }

        // This method is called after the project is created.
        public void RunFinished()
        {
        }

        public void RunStarted(object automationObject,
            Dictionary<string, string> replacementsDictionary,
            WizardRunKind runKind, object[] customParams)
        {
            try
            {
                // Display a form to the user. The form collects 
                // input for the custom message.
                inputForm = new UserInputForm();
                inputForm.ShowDialog();

                customMessage = inputForm.get_CustomMessage();

                // Add custom parameters.
                replacementsDictionary.Add("$custommessage$", 
                    customMessage);
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.ToString());
            }
        }

        // This method is only called for item templates,
        // not for project templates.
        public bool ShouldAddProjectItem(string filePath)
        {
            return true;
        }        
    }
}

ユーザー入力フォーム

ユーザー入力フォームには、カスタム パラメータを入力するための簡単なフォームが用意されています。このフォームには、textBox1 という名前のテキスト ボックスおよび button1 という名前のボタンがあります。このボタンをクリックすると、テキスト ボックスのテキストが customMessage パラメータに格納されます。

Windows フォームをソリューションに追加するには

  1. [プロジェクト] メニューの [新しい項目の追加] をクリックします。

  2. [Windows フォーム] をクリックし、ファイルに「UserInputForm.cs」という名前を付けて、[OK] をクリックします。

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;

namespace CustomWizard
{
    public partial class UserInputForm : Form
    {
        private string customMessage;

        public UserInputForm()
        {
            InitializeComponent();
        }
       
        public string get_CustomMessage()
        {
            return customMessage;
        }

        private void button1_Click(object sender, EventArgs e)
        {
            customMessage = textBox1.Text;

            this.Dispose();
        }
    }
}

グローバル アセンブリ キャッシュへのアセンブリのインストール

IWizard を実装するアセンブリは、厳密な名前で署名して、グローバル アセンブリ キャッシュにインストールする必要があります。

アセンブリをグローバル アセンブリ キャッシュにインストールするには

  1. アセンブリに厳密な名前で署名します。詳細については、「方法 : 厳密な名前でアセンブリに署名する」または「方法 : アセンブリに署名する (Visual Studio)」を参照してください。

  2. 厳密な名前付きアセンブリをグローバル アセンブリ キャッシュにインストールします。詳細については、「方法 : グローバル アセンブリ キャッシュにアセンブリをインストールする」を参照してください。

テンプレートとして使用するプロジェクトの作成

この例でテンプレートとして使用されるプロジェクトは、カスタム ウィザードのユーザー入力フォームで指定されたメッセージを表示するコンソール アプリケーションです。

サンプル プロジェクトを作成するには

  1. Visual C# コンソール アプリケーションを新しく作成します。

  2. アプリケーションの Main メソッドに次のコード行を追加します。

    Console.WriteLine("$custommessage$");
    

    $custommessage$ パラメータは、プロジェクトをテンプレートから作成する際にユーザー入力フォームに入力したテキストで置き換えられます。

  3. [ファイル] メニューの [テンプレートのエクスポート] をクリックします。

  4. テンプレートのエクスポート ウィザードで、[プロジェクト テンプレート] をクリックし、適切なプロジェクトを選択して、[次へ] をクリックします。

  5. テンプレートのエクスポート ウィザードで、テンプレートの説明情報を入力します。[テンプレートを自動的に Visual Studio にインポート] チェック ボックスをオンにし、[完了] をクリックします。

    これで、テンプレートは [新しいプロジェクト] ダイアログ ボックスに表示されるようになりますが、カスタム ウィザードは使用しません。

テンプレートにエクスポートされる前のコード ファイル全体の例を次に示します。

using System;
using System.Collections.Generic;
using System.Text;

namespace TemplateProject
{
    class WriteMessage
    {
        static void Main(string[] args)
        {
            Console.WriteLine("$custommessage$");
        }
    }
}

テンプレートの変更

テンプレートが作成され、[新しいプロジェクト] ダイアログ ボックスに表示されたら、前の手順で作成したアセンブリを使用するように、そのテンプレートを変更する必要があります。

カスタム ウィザードをテンプレートに追加するには

  1. テンプレートを含む .zip ファイルを探します。

    1. [ツール] メニューの [オプション] をクリックします。

    2. [プロジェクトおよびソリューション] をクリックします。

    3. [Visual Studio ユーザー プロジェクト テンプレートの場所] ボックスを確認します。詳細については、「[全般] ([オプション] ダイアログ ボックス - [プロジェクトおよびソリューション])」を参照してください。

    既定の場所は、My Documents\Visual Studio 2008\Templates\ProjectTemplates です。

  2. .zip ファイルを解凍します。

  3. Visual Studio で .vstemplate ファイルを開きます。

  4. TemplateContent 要素の後に、カスタム ウィザード アセンブリの厳密な名前の付いた WizardExtension 要素 (Visual Studio テンプレート) 要素を追加します。アセンブリの厳密な名前を検索する方法の詳細については、「方法 : グローバル アセンブリ キャッシュの内容を表示する」および「方法 : 厳密な名前のアセンブリを参照する」を参照してください。

    WizardExtension 要素の例を次に示します。

    <WizardExtension>
        <Assembly>CustomWizard, Version=1.0.0.0, Culture=Neutral, PublicKeyToken=fa3902f409bb6a3b</Assembly>
        <FullClassName>CustomWizard.IWizardImplementation</FullClassName>
    </WizardExtension>
    

カスタム ウィザードの使用

これで、テンプレートからプロジェクトを作成し、カスタム ウィザードを使用できるようになりました。

カスタム ウィザードを使用するには

  1. [ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。

  2. [新しいプロジェクト] ダイアログ ボックスで、テンプレートを指定し、名前を入力して、[OK] をクリックします。

    ウィザードのユーザー入力フォームが開きます。

  3. カスタム パラメータの値を入力し、ボタンをクリックします。

    ウィザードのユーザー入力フォームが終了し、プロジェクトがテンプレートから作成されます。

  4. ソリューション エクスプローラで、ソース コード ファイルを右クリックし、[コードの表示] をクリックします。

    $custommessage$ は、ウィザードのユーザー入力フォームに入力されたテキストで置き換えられています。

参照

参照

WizardExtension 要素 (Visual Studio テンプレート)

IWizard

その他の技術情報

詳細なテンプレート手順