Solution2.GetProjectItemTemplate 方法
傳回指定專案項目範本的路徑。
命名空間: EnvDTE80
組件: EnvDTE80 (在 EnvDTE80.dll 中)
語法
'宣告
Function GetProjectItemTemplate ( _
TemplateName As String, _
Language As String _
) As String
string GetProjectItemTemplate(
string TemplateName,
string Language
)
String^ GetProjectItemTemplate(
String^ TemplateName,
String^ Language
)
abstract GetProjectItemTemplate :
TemplateName:string *
Language:string -> string
function GetProjectItemTemplate(
TemplateName : String,
Language : String
) : String
參數
- TemplateName
型別:System.String
範本名稱。
- Language
型別:System.String
用以撰寫範本的語言。
傳回值
型別:System.String
專案項目範本的完整名稱。
備註
專案範本會儲存為 zip 檔。 這個方法會以名稱和語言要求專案,並且傳回範本路徑。
GetProjectItemTemplate 的參數可以藉由不同的方式加以提供,如下所示:
將 Smart Device Visual Basic Virtual Project 的 GUID 當做 Language 參數,並將 zip 檔的檔名當做 TemplateName 參數進行傳遞。
GetProjectItemTemplate("NETCFv2-Class.zip", "{3114F5B0-E435-4bc5-A03D-168E20D9BF83}");
將智慧型裝置 Visual Basic Virtual Project 的 GUID 當做 Language 參數,並將 "Class" 字串當做 TemplateName 參數進行傳遞。 這個字串 "Class" 係衍生自資料夾階層架構,並且被稱為使用者介面 (UI) 字串。 其他的 UI 字串為 "HTML Page" 和 "Splash Screen", 這些 UI 字串會因為地區設定而異。 因此傳遞 TemplateName 參數最安全的方式便是使用 zip 檔的名稱。
GetProjectItemTemplate("Class", "{3114F5B0-E435-4bc5-A03D-168E20D9BF83}");
將 "VisualBasic" 當做 Language 參數,並將 zip 檔的檔名當做 TemplateName 參數進行傳遞。 因為對智慧型裝置而言,NETCFv2-Class.zip 為獨一無二的檔名,所以這個作法可行。
GetProjectItemTemplate("NETCFv2-Class.zip", "VisualBasic/SmartDevice-NETCFv2");
您也可以為專案項目建立自訂範本。 若要指定用來儲存範本的目錄,請按一下 [工具] 功能表上的 [選項], 然後在 [選項] 對話方塊的左窗格中,按一下 [專案和方案], 在 [Visual Studio 使用者項目範本位置] 方塊中輸入範本的路徑, 或者,您也可以接受預設位置。
自訂範本必須具有獨特的檔案名稱,不能與下列位置定義的檔案名稱相互衝突:
<drive>:\Program Files\Microsoft Visual Studio 8\Common7\IDE\ItemTemplates\Language.
請確定要使用長檔名 (不能使用 8dot3)。 如需詳細資訊,請參閱建立專案範本和項目範本。
範例
如需如何執行增益集程式碼的詳細資訊,請參閱 HOW TO:編譯和執行 Automation 物件模型程式碼範例。
下列範例會將 HTML 網頁加入方案中。
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)
SaveAsExample(_applicationObject)
End Sub
Sub SaveAsExample(ByVal dte As DTE2)
' This add-in adds an HTML page to a solution.
' Open a Visual Basic solution in Visual Studio
' before running this example.
Dim soln As Solution2 = _
CType(_applicationObject.Solution, Solution2)
Dim prj As Project
Dim prjItem As ProjectItem
Dim itemPath As String
Try
prj = soln.Projects.Item(1)
itemPath = soln.GetProjectItemTemplate("HTMLPage.zip", _
"VisualBasic")
' Create a new project item based on the template.
' (In this case, an HTML page.)
prjItem = _
prj.ProjectItems.AddFromTemplate(itemPath, "MyNewHtml")
Catch ex As SystemException
MsgBox("ERROR: " & ex.ToString())
End Try
End Sub
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.
SolnGetProjetItemExample((DTE2)_applicationObject);
}
public void SolnGetProjetItemExample(DTE2 dte)
{
// This add-in adds an item to a Visual Basic solution.
// Open a Visual Basic solution in Visual Studio
// before running this example.
Solution2 soln = (Solution2)_applicationObject.Solution;
Project prj;
ProjectItem prjItem;
string itemPath;
try
{
prj = soln.Projects.Item(1);
itemPath =
soln.GetProjectItemTemplate("HTMLPage.zip", "VisualBasic");
// Create a new project item based on the template.
// (In this case, an HTML page.)
prjItem =
prj.ProjectItems.AddFromTemplate(itemPath, "MyNewHtml");
}
catch (SystemException ex)
{
MessageBox.Show("ERROR: " + ex);
}
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。