Solution2.GetProjectItemTemplate - метод

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает путь к указанному шаблону элемента проекта.

Пространство имен: EnvDTE80
Сборка: EnvDTE80 (в EnvDTE80.dll)

Синтаксис

'Декларация
Function GetProjectItemTemplate ( _
    TemplateName As String, _
    Language As String _
) As String
'Применение
Dim instance As Solution2
Dim TemplateName As String
Dim Language As String
Dim returnValue As String

returnValue = instance.GetProjectItemTemplate(TemplateName, _
    Language)

string GetProjectItemTemplate(
    string TemplateName,
    string Language
)

String^ GetProjectItemTemplate(
    String^ TemplateName, 
    String^ Language
)

function GetProjectItemTemplate(
    TemplateName : String, 
    Language : String
) : String

Параметры

TemplateName
Тип: System.String
Имя шаблона.

Language
Тип: System.String
Язык, использовавшийся для создания шаблона.

Возвращаемое значение

Тип: System.String
Полный путь к шаблону элемента проекта.

Заметки

Шаблоны проектов хранятся в виде ZIP-файлов. Этот метод запрашивает проект по имени и языку и возвращает путь к шаблону.

Параметры GetProjectItemTemplate могут предоставляться несколькими различными способами, как показано ниже.

Идентификатор GUID для Smart Device Visual Basic Virtual Project передается в виде параметра Language, а имя ZIP-файла — в виде TemplateName.
```
GetProjectItemTemplate("NETCFv2-Class.zip", "{3114F5B0-E435-4bc5-A03D-168E20D9BF83}");
```
Идентификатор GUID для Smart Device Visual Basic Virtual Project передается в виде параметра Language, а строка "Class" — в виде TemplateName. Строка "Class" ("Класс") получается из иерархии папок и на нее ссылаются как на строку интерфейса пользователя. Другие строки интерфейса пользователя: "HTML Page" ("Страница HTML") и "Splash Screen" ("Экран-заставка"). Строки пользовательского интерфейса зависят от языкового стандарта. Использование имени ZIP-файла — это самый безопасный способ передачи параметра TemplateName.
```
GetProjectItemTemplate("Class", "{3114F5B0-E435-4bc5-A03D-168E20D9BF83}");
```
Строка "VisualBasic" передается в параметре Language, а имя ZIP-файла в параметре TemplateName. Это работает, так как файл NETCFv2-Class.zip уникален для Smart Devices.
```
GetProjectItemTemplate("NETCFv2-Class.zip", "VisualBasic/SmartDevice-NETCFv2");
```

Кроме того, можно создавать собственные шаблоны для элементов проектов. Чтобы выбрать папку для хранения шаблонов, в меню Сервис выберите Параметры. В левой части диалогового окна Параметры выберите Проекты и решения. Введите пути для своих шаблонов в поля Размещение пользовательских шаблонов элементов Visual Studio. Также можно использовать местоположение по умолчанию.

Имена файлов пользовательских шаблонов должны быть уникальными и не должны конфликтовать с именами файлов, определенными в:

<диск>:\Program Files\Microsoft Visual Studio 8\Common7\IDE\ItemTemplates\язык.

Следует использовать длинные имена файлов (а не имена в формате 8.3). Дополнительные сведения см. в разделе Создание шаблонов проектов и элементов.

Примеры

Сведения о запуске этого кода надстройки см. в разделе Практическое руководство. Компиляция и выполнение примеров кода модели объектов автоматизации.

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);
    }
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

Solution2 Интерфейс

Solution2 - члены

EnvDTE80 - пространство имен

Поделиться через