Solution2.GetProjectTemplate メソッド
指定されたプロジェクト テンプレートのパスを返します。
名前空間: EnvDTE80
アセンブリ: EnvDTE80 (EnvDTE80.dll 内)
構文
'宣言
Function GetProjectTemplate ( _
TemplateName As String, _
Language As String _
) As String
string GetProjectTemplate(
string TemplateName,
string Language
)
String^ GetProjectTemplate(
String^ TemplateName,
String^ Language
)
abstract GetProjectTemplate :
TemplateName:string *
Language:string -> string
function GetProjectTemplate(
TemplateName : String,
Language : String
) : String
パラメーター
- TemplateName
型 : System.String
テンプレートの名前。
- Language
型 : System.String
テンプレートの書き込みに使用されている言語。
戻り値
型 : System.String
プロジェクト テンプレートの完全名。
解説
プロジェクト テンプレートは、zip ファイルとして格納されます。このメソッドは、名前と言語でプロジェクトを要求し、テンプレートのパスを返します。
GetProjectTemplate のパラメーターは、次のようなさまざまな方法で指定できます。
"CSharp" を Language パラメーターとして、zip ファイルの名前を TemplateName パラメーターとして渡します。
GetProjectTemplate("PocketPC2003-ClassLibrary.zip", "CSharp");
"CSharp" を Language パラメーターとして渡し、部分ファイル パス "PocketPC2003\ClassLibrary.vstemplate" も渡して、一意の TemplateName を指定します。
GetProjectTemplate("PocketPC2003\ClassLibrary.vstemplate", "CSharp");//partial file path
文字列 "CSharp" を Language パラメーターとして、文字列 "Pocket PC 2003 Class Library" を TemplateName パラメーターとして渡します。文字列 "Pocket PC 2003 Class Library" はフォルダー階層から派生し、ユーザー インターフェイス (UI) 文字列と呼ばれています。その他の UI 文字列の例としては、"Console Application" と "Windows Application" があります。
[!メモ]
UI 文字列は、ロケールによって異なります。zip ファイルを使用すると、最も安全に TemplateName パラメーターを渡すことができます。
GetProjectTemplate("Pocket PC 2003 Class Library", "CSharp");
文字列 "CSharp" を Language パラメーターとして、文字列 "PocketPC2003\Pocket PC 2003 Class Library" を TemplateName パラメーターとして渡します。これには、テンプレートを一意に指定する UI 文字列と部分パスが含まれます。
GetProjectTemplate("PocketPC2003\Pocket PC 2003 Class Library", "CSharp");
カスタムのプロジェクト テンプレートを独自に作成することもできます。テンプレートを格納するディレクトリを指定するには、[ツール] メニューの [オプション] をクリックします。[オプション] ダイアログ ボックスの左ペインで、[プロジェクトおよびソリューション] をクリックします。テンプレートのパスを [Visual Studio ユーザー プロジェクト テンプレートの場所] ボックスに入力します。または、既定の場所を使用できます。
カスタム テンプレートには、次の場所で定義されたファイル名と競合しない一意のファイル名が必要です。
- <drive>:\Program Files\Microsoft Visual Studio 8\Common7\IDE\ProjectTemplates\Language
8dot3 形式ではなく長いファイル名を使用するようにします。詳細については、「Creating Project and Item Templates」を参照してください。
例
このアドイン コードの実行方法については、「方法 : オートメーション オブジェクト モデルのコード例をコンパイルおよび実行する」を参照してください。
次の例は、ソリューションを作成し、コンソール アプリケーション プロジェクトを追加する方法を示しています。
Public Sub OnConnection(ByVal application As Object, _
ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
ByRef custom As Array) Implements IDTExtensibility2.OnConnection
_applicationObject = CType(application, DTE2)
_addInInstance = CType(addInInst, AddIn)
SolutionExample(_applicationObject)
End Sub
Sub SolutionExample(ByVal dte As DTE2)
' This function creates a solution and adds a Visual Basic Console
' project to it.
Try
Dim soln As Solution2 = CType(DTE.Solution, Solution2)
Dim vbTemplatePath As String
' This path must exist on your computer.
' Replace <file path> below with an actual path.
Dim vbPrjPath As String = "<file path>"
MsgBox("starting")
' Get the project template path for a Visual Basic console project.
vbTemplatePath = soln.GetProjectTemplate _
("ConsoleApplication.zip", "VisualBasic")
' Create a new Visual Basic Console project using the template obtained
' above.
soln.AddFromTemplate(vbTemplatePath, vbPrjPath, _
"New Visual Basic Console Project", False)
MsgBox("done")
Catch ex As System.Exception
MsgBox(ex.ToString)
End Try
End Sub
//make sure to add this reference to your project references
using System.Windows.Forms;
public void OnConnection(object application,
Extensibility.ext_ConnectMode connectMode, object addInInst,
ref System.Array custom)
{
_applicationObject = (DTE2)application;
_addInInstance = (AddIn)addInInst;
// Pass the applicationObject member variable to the code example.
SolutionExample((DTE2)_applicationObject);
}
public void SolutionExample(DTE2 dte)
{
// This function creates a solution and adds a Visual C# Console
// project to it.
try{
Solution2 soln = (Solution2)_applicationObject.Solution;
String csTemplatePath;
// The file path must exist on your computer.
// Replace <file path> below with an actual path.
String csPrjPath = "<file path>";
"<file path>MessageBox.Show("Starting...");
"<file path>"<file path>csTemplatePath =
soln.GetProjectTemplate("ConsoleApplication.zip", "CSharp");
// Create a new C# Console project using the template obtained
// above.
soln.AddFromTemplate(csTemplatePath, csPrjPath,
"New CSharp Console Project", false);
MessageBox.Show("Done!");
}
catch(SystemException ex)
{
MessageBox.Show("ERROR: " + ex);
}
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。