この記事では、 テンプレートのエクスポート ウィザード または手動でアイテム テンプレートを作成する方法と、アイテム テンプレートを編集して使用する方法について説明します。 テンプレートが複数のファイルで構成されている場合は、「 方法: 複数ファイル項目テンプレートを作成する」も参照してください。
項目テンプレートを追加する
Visual Studio でプロジェクトを作成または開きます。
[プロジェクト>新しい項目の追加] を選択するか、Ctrl++キーを押します。
[ 新しい項目の追加 ] ダイアログ ボックスで、項目を選択し、[ 追加 ] を選択してプロジェクトに追加します。
必要に応じて項目を変更し、項目内の場所 (ある場合) にパラメーターの置換を行う必要があることを示します。 詳細については、「 方法: テンプレートのパラメーターを置き換える」を参照してください。
アイテムを保存します。
[プロジェクト>Export テンプレート] を選択します。 テンプレートのエクスポート ウィザードが開きます。
[ テンプレートの種類の選択 ] ページで、[ 項目テンプレート] を選択し、項目を含むプロジェクトを選択して、[ 次へ] を選択します。
[ エクスポートする項目の選択 ] ページで、テンプレートを作成する項目を選択し、[ 次へ] を選択します。
[ 項目参照の選択 ] ページで、テンプレートに含めるアセンブリ参照を選択し、[ 次へ] を選択します。
[ テンプレート オプションの選択] ページで、次の操作を行います。
テンプレート名とオプションの説明、アイコンイメージ、プレビューイメージを入力します。
項目のアイコンファイルは .ico ファイルであり、Visual Studio のイメージとアイコンで説明されているように示されています。 プレビュー イメージは、[ 新しい項目の追加 ] ダイアログ ボックスに表示される 200 x 200 のイメージです。 Visual Studio イメージ ライブラリをダウンロードして、Visual Studio スタイルと一貫性のあるアイコンを取得できます。
Visual Studio にテンプレートを自動的にインポートするかどうかを選択し、出力ファイル フォルダーにエクスプローラー ウィンドウを表示します。
完了 を選択します。
テンプレート ファイルは .zip ファイルに圧縮され、ウィザードの [出力場所] に表示されるディレクトリにコピーされます。 既定の場所は 、\Documents\Visual Studio <version>\My Exported Templates%USERPROFILE%です。
[ テンプレートを Visual Studio に自動的にインポートする] を選択した場合は、 .zip ファイルもユーザー ItemTemplates ディレクトリに追加されます。 既定の場所は 、\Documents\Visual Studio <version>\Templates\ItemTemplates%USERPROFILE%です。
これで、プロジェクトで項目テンプレートを使用できるようになりました。
項目テンプレートを使用する
- テンプレートの作成時 に [テンプレートを Visual Studio に自動的にインポート する] を選択しなかった場合は、 .zip ファイルを ItemTemplates ディレクトリにコピーします。 既定の場所は 、\Documents\Visual Studio <version>\Templates\ItemTemplates%USERPROFILE%です。
- Visual Studio を閉じてから、もう一度開きます。
- 新しいプロジェクトを作成するか、既存のプロジェクトを開き、[プロジェクト] を選択します>新しい項目の追加
- [ 新しい 項目の追加] ダイアログ ボックスから項目テンプレートを選択します。 テンプレートのエクスポート ウィザードで説明を追加した場合は、ダイアログ ボックスの右側に説明が表示されます。
- [ 追加] を選択して、テンプレート 項目をプロジェクトに追加します。
.vstemplate ファイルを編集する
ウィザードによって基本的なテンプレートが作成されますが、場合によっては、テンプレートをエクスポートした後に .vstemplate ファイルを手動で変更する必要があります。 たとえば、ユニバーサル Windows アプリ プロジェクトの [新しい項目の追加] ダイアログに項目を表示する場合は、 .vstemplate ファイルを編集する必要があります。
- エクスポートした項目テンプレート .zip ファイルを抽出し、Visual Studio で .vstemplate ファイルを開きます。
- 必要に応じてファイルを編集します。 C# ユニバーサル Windows プロジェクトの場合は、
<TemplateID>Microsoft.CSharp.Class</TemplateID>要素内に<TemplateData>を追加します。 - .vstemplate ファイルを保存して閉じ、.zip ファイルに置き換えます。
特定のプロジェクト サブタイプのテンプレートを有効にする
.vstemplate ファイルを編集して、アイテム テンプレートが特定のプロジェクト サブタイプ (Windows、Office、データベース、Web など) に対してのみ表示されるように指定できます。
- 編集のために .vstemplate ファイルを開きます。
- 値を、
ProjectType、Windows、またはOfficeして、Database要素の直後にWeb要素を追加します。 たとえば、<ProjectSubType>Database</ProjectSubType>と指定します。
次の例は、 プロジェクトの Office ファイルを示しています。
<VSTemplate Version="2.0.0" Type="Item" Version="2.0.0">
<TemplateData>
<Name>Class</Name>
<Description>An empty class file</Description>
<Icon>Class.ico</Icon>
<ProjectType>CSharp</ProjectType>
<ProjectSubType>Office</ProjectSubType>
<DefaultName>Class.cs</DefaultName>
</TemplateData>
<TemplateContent>
<ProjectItem>Class1.cs</ProjectItem>
</TemplateContent>
</VSTemplate>
項目テンプレートを手動で作成する
ウィザードを使用する代わりに、項目テンプレートを最初から手動で作成できます。
- プロジェクトを作成し、項目を追加します。
- パラメーターの置換を行う場所を追加するなど、必要に応じて項目を変更し、項目を保存します。
- XML ファイルを作成し、プロジェクト項目ファイルと同じディレクトリに .vstemplate ファイル拡張子を付けて保存します。
- 前の例に示すように、項目テンプレートメタデータを .vstemplate XML ファイルに追加します。 詳細については、「 テンプレート スキーマ リファレンス (拡張性)」を参照してください。
- .vstemplate ファイルを保存して閉じます。
- Windows エクスプローラーで、 .vstemplate ファイルなど、テンプレートに含めるファイルを選択します。 選択範囲を右クリックし、[圧縮]>[ZIP ファイル] を選択します。
- 結果の .zip ファイルをコピーし、Visual Studio ユーザー項目テンプレートの場所に貼り付けます。 既定のディレクトリは \Documents\Visual Studio <version>\Templates\ItemTemplates%USERPROFILE%です。