テンプレート名

[アーティクル]
06/10/2015

テンプレート内でパラメーターを使用すると、テンプレートがインスタンス化されたときに、テンプレート内の主要な部分 (クラス名や名前空間など) の値を置き換えることができます。[新しいプロジェクト] ダイアログボックスまたは [新しい項目の追加] ダイアログボックスで [OK] をクリックすると、これらのパラメーターが、バックグラウンドで実行されているテンプレートウィザードによって置き換えられます。

テンプレートパラメーターの宣言と有効化

テンプレートパラメーターは、$parameter という形式で宣言します。次のように記述します。

$safeprojectname$
$guid1$
$guid5$

テンプレートでパラメーター置換を有効にするには

テンプレートの .vstemplate ファイル内で、パラメーター置換を有効にする項目に対応する ProjectItem 要素を見つけます。
ProjectItem 要素の ReplaceParameters 属性を true に設定します。
プロジェクト項目のコードファイルで、必要に応じてパラメーターを含めます。たとえば、次のパラメーターは、ファイル内で名前空間に対して安全なプロジェクト名が使用されることを指定します。
```
namespace $safeprojectname$
```

予約済みテンプレートパラメーター

テンプレートで使用できる予約済みテンプレートパラメーターを次の表に示します。

[!メモ]

テンプレートパラメーターでは、大文字と小文字が区別されます。

パラメーター	説明
clrversion	共通言語ランタイム (CLR: Common Language Runtime) の現在のバージョン。
GUID [1-10]	プロジェクトファイルでプロジェクト GUID を置き換えるために使用される GUID。最大 10 の GUID を指定できます (たとえば、guid1)。
itemname	[新しい項目の追加] ダイアログボックスでユーザーが指定した名前。
machinename	現在のコンピューター名 (たとえば、Computer01)。
projectname	[新しいプロジェクト] ダイアログボックスでユーザーが指定した名前。
registeredorganization	HKLM\Software\Microsoft\Windows NT\CurrentVersion\RegisteredOrganization のレジストリキー値。
rootnamespace	現在のプロジェクトのルート名前空間。このパラメーターは、項目テンプレートにのみ適用されます。
safeitemname	[新しい項目の追加] ダイアログボックスでユーザーが指定した名前から、安全でないすべての文字とスペースを削除したもの。
safeprojectname	[新しいプロジェクト] ダイアログボックスでユーザーが指定した名前から、安全でないすべての文字とスペースを削除したもの。
time	DD/MM/YYYY 00:00:00 の形式で表した現在の時間。
SpecificSolutionName	ソリューションの名前。[ソリューションのディレクトリを作成] がオンになっている場合は、SpecificSolutionName にソリューション名が指定されます。[ソリューションのディレクトリを作成] がオフになっている場合、SpecificSolutionName は空白です。
userdomain	現在のユーザードメイン。
username	現在のユーザー名。
webnamespace	現在の Web サイトの名前。このパラメーターは、Web フォームテンプレートで一意のクラス名を保証するために使用されます。この Web サイトが Web サーバーのルートディレクトリにある場合、このテンプレートパラメーターは Web サーバーのルートディレクトリとして解決されます。
year	YYYY の形式で表した現在の年。

カスタムテンプレートパラメーター

パラメーター置換時に使用される既定の予約済みテンプレートパラメーターの他に、独自のテンプレートパラメーターと値を指定できます。詳細については、「CustomParameters 要素 (Visual Studio テンプレート)」を参照してください。

例: ファイル名の置換

TargetFileName 属性を指定してパラメーターを使用することにより、プロジェクト項目に対して変数ファイル名を指定できます。たとえば、.exe ファイルが $projectname$ によって指定されるプロジェクト名をファイル名として使用するように指定できます。

<TemplateContent>
    <ProjectItem
        ReplaceParameters="true"
        TargetFileName="$projectname$.exe">
            File1.exe
    </ProjectItem>
      ...
</TemplateContent>

例: 名前空間名に対するプロジェクト名の使用

Visual C# クラスファイル Class1.cs で名前空間に対してプロジェクト名を使用するには、次の構文を使用します。

#region Using directives

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

#endregion

namespace $safeprojectname$
{
    public class Class1
        {
            public Class1()
                {

                }
         }
}

プロジェクトテンプレートの .vstemplate ファイルで、ファイル Class1.cs を参照するときに次の XML を含めます。

<TemplateContent>
    <ProjectItem ReplaceParameters="true">
        Class1.cs
    </ProjectItem>
    ...
</TemplateContent>

参照

その他の技術情報

プロジェクトと項目テンプレートのカスタマイズ

テンプレート名

テンプレート パラメーターの宣言と有効化