Solution3.GetProjectItemTemplate 方法 (String, String)

發行項
10/28/2012

傳回指定專案項目範本的路徑。

命名空間： EnvDTE90
組件： EnvDTE90 (在 EnvDTE90.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 的參數可以藉由不同的方式加以提供，如下所示：

將智慧型裝置 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 9\Common7\IDE\ItemTemplates\Language.

請確定要使用長檔名 (不能使用 8dot3)。如需詳細資訊，請參閱Creating Project and Item Templates。

範例

如需如何執行增益集程式碼的詳細資訊，請參閱 HOW TO：編譯和執行 Automation 物件模型程式碼範例。

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 Solution3 = _
    CType(_applicationObject.Solution, Solution3)
    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.
 
    Solution3 soln = (Solution3)_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);
    }
}