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
    类型:String

    模板的名称。

  • Language
    类型:String

    用于编写模板的语言。

返回值

类型:String
项目项模板的全名。

备注

项目模板存储为 zip 文件。 此方法按名称和语言查找项目,并返回模板的路径。

可以按许多不同的方法提供 GetProjectItemTemplate 的参数,如下所示:

  • 以 Language 参数形式传入智能设备 Visual Basic 虚拟项目的 GUID,以 TemplateName 形式传入 zip 文件的名称。

    GetProjectItemTemplate("NETCFv2-Class.zip", "{3114F5B0-E435-4bc5-A03D-168E20D9BF83}");
    
  • 以 Language 参数形式传入智能设备 Visual Basic 虚拟项目的 GUID,以 TemplateName 形式传入字符串“Class”。 字符串“Class”从文件夹层次结构派生,它被称作用户界面 (UI) 字符串。 其他 UI 字符串有“HTML 页”和“初始屏幕”。 UI 字符串与区域设置有关。 使用 zip 文件的名称是最安全的传递 TemplateName 参数的方法。

    GetProjectItemTemplate("Class", "{3114F5B0-E435-4bc5-A03D-168E20D9BF83}");
    
  • 以 Language 参数形式传入字符串“VisualBasic”,以 TemplateName 参数形式传入 zip 文件的名称。 这之所以有效,是因为 NETCFv2-Class.zip 对于智能设备是唯一的。

    GetProjectItemTemplate("NETCFv2-Class.zip", "VisualBasic/SmartDevice-NETCFv2");
    

还可以为项目项创建自定义模板。 若要指定将在其中存储您的模板的目录,请单击**“工具”菜单中的“选项”。 在“选项”对话框的左侧窗格中,单击“项目和解决方案”。 在“Visual Studio 用户项模板位置”**框中为您的模板键入路径。 或者,您可以接受默认位置。

自定义模板需要唯一的文件名,且不与下面路径中定义的文件名冲突:

<驱动器>:\Program Files\Microsoft Visual Studio 8\Common7\IDE\ItemTemplates\语言。

请确保使用长文件名(而非 8.3 文件名)。 有关详细信息,请参阅 Creating Project and Item Templates

示例

有关如何运行此外接程序代码的信息,请参见如何:编译和运行自动化对象模型代码示例

下面的示例向解决方案中添加一个 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 安全性

请参阅

参考

Solution2 接口

EnvDTE80 命名空间