Solution3.GetProjectItemTemplates - метод

Статья
11/05/2008

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

Возвращает коллекцию шаблонов элементов проекта для указанного проекта.

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

Синтаксис

'Декларация
Function GetProjectItemTemplates ( _
    Language As String, _
    CustomDataSignature As String _
) As Templates
'Применение
Dim instance As Solution3
Dim Language As String
Dim CustomDataSignature As String
Dim returnValue As Templates

returnValue = instance.GetProjectItemTemplates(Language, _
    CustomDataSignature)

Templates GetProjectItemTemplates(
    string Language,
    string CustomDataSignature
)

Templates^ GetProjectItemTemplates(
    String^ Language, 
    String^ CustomDataSignature
)

function GetProjectItemTemplates(
    Language : String, 
    CustomDataSignature : String
) : Templates

Параметры

Language
Тип: System.String
Язык, используемый для написания шаблона элемента проекта.

CustomDataSignature
Тип: System.String
Подпись для любых метаданных, связанных с шаблоном элемента проекта.

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

Тип: EnvDTE90.Templates
Коллекция шаблонов, содержащая имена всех шаблонов элементов проекта.

Заметки

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

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

В качестве параметра Language передается идентификатор GUID для виртуального проекта интеллектуального устройства Visual Basic, а в качестве параметра TemplateName — имя ZIP-файла.
```
GetProjectItemTemplate("NETCFv2-Class.zip", "{3114F5B0-E435-4bc5-A03D-168E20D9BF83}");
```
В качестве параметра Language передается идентификатор GUID для виртуального проекта интеллектуального устройства Visual Basic, а в качестве параметра TemplateName — строка "Class". Строка "Class" формируется по иерархии папок и считается строкой интерфейса пользователя. Другие строки интерфейса пользователя: "HTML Page" и "Splash Screen". Строки пользовательского интерфейса зависят от языкового стандарта. Использование имени 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 9\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)
    SolutionExample(_applicationObject)
End Sub

Sub SolutionExample(ByVal dte As DTE2)
    ' This function creates a solution and adds a Visual C# Console
    ' project to it.
    Try
        Dim soln As Solution3 = CType(DTE.Solution, Solution3)
        Dim csTemplatePath As String
        ' This path must exist on your computer.
        ' Replace <file path> below with an actual path.
        Dim csPrjPath As String = "<file path>"
        MsgBox("starting")
        ' Get the project template path for a C# console project.
        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)
        MsgBox("done")
    Catch ex As System.Exception
        MsgBox(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.
    SolutionExample((DTE2)_applicationObject);
}

public void SolutionExample(DTE2 dte)
{
    // This function creates a solution and adds a Visual C# Console
    // project to it.
    try{
        Solution3 soln = (Solution3)_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);
    }
}

Разрешения

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