ItemOperations.AddNewItem - метод

Статья
05/17/2015

Добавляет новый элемент к текущему проекту.

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

Синтаксис

'Декларация
Function AddNewItem ( _
    Item As String, _
    Name As String _
) As ProjectItem

ProjectItem AddNewItem(
    string Item,
    string Name
)

ProjectItem^ AddNewItem(
    [InAttribute] String^ Item, 
    [InAttribute] String^ Name
)

abstract AddNewItem : 
        Item:string * 
        Name:string -> ProjectItem

function AddNewItem(
    Item : String, 
    Name : String
) : ProjectItem

Параметры

Item
Тип: String

Необязательно. Виртуальный путь к элементу, определяемый либо строкой ресурса пользовательского интерфейса (определяемой ниже в разделе "Примечания"), либо, иногда, как показано в диалоговом окне Новый файл в формате "category\templatename". Значение Category берется из левой области диалогового окна, а значение templatename — из правой. Например, чтобы добавить новый HTML-файл в проект Visual Basic, можно использовать путь "General\HTML Page". Дополнительные сведения см. в разделе "Примечания".

Name
Тип: String

Необязательно. Отображаемое имя, которое следует присвоить элементу после добавления в проект.

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

Тип: EnvDTE.ProjectItem
Объект ProjectItem.

Заметки

Модели AddNewItem диалогового окна Создать файл. Содержимое этого диалогового окна зависит от типа проекта. Существует два способа определить значение, которое нужно поместить в параметр Item: взять значение из диалогового окна Создать файл, или найти значение в соответствующем файле ресурса пользовательского интерфейса.

Чтобы добавить элементы в проект с помощью первого метода, следует посмотреть в диалоговом окне Создать файл, какие элементы доступны для проекта. Диалоговое окно Создать файл делится на две области Категории и Шаблоны. Параметр Item метода AddNewItem

в формате category\templatename. Category обычно находится в левой части диалогового окна (Категории), а templatename — в правой части (Шаблоны). Например, чтобы добавить новый HTML-файл в проект Visual Basic, можно использовать путь "General\HTML Page". Однако, в связи с различиями языков, точные значения для него не всегда правильно отображаются в диалоговом окне Создать файл.

Более согласованный и надежный метод получения точных значений для параметра Item — это найти необходимую строку в файле ресурсов пользовательского интерфейса для каждого языка программирования. Затем используйте это значение вместе с именем элемента, который нужно добавить, как он отображается в диалоговых окнах Создать файл и Добавление нового элемента. Например, чтобы добавить новый класс файла Visual Basic в проект, можно использовать AddNewItem("Visual Basic Items\Class", "test.vb"). Чтобы добавить новый класс файла Visual C# в проект, можно использовать AddNewItem("Visual C# Project Items\Class", test.cs");.

Строка "Visual Basic Items" (а также элементы других языков) находится следующим образом:

Чтобы найти файл Visual Basic, откройте следующий раздел реестра: "HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\8.0\Projects\{F184B08F-C81C-45f6-A57F-5ABD9991F28F}\AdditemTemplates\TemplateDirs\{164B10B9-B200-11D0-8C61-00A0C91E29D5}\ /1". Значение по умолчанию: #3082.
Откройте файл msvbprjui.dll в Visual Studio при помощи редактора ресурсов. Чтобы открыть файл, последовательно выберите в меню "Файл" пункты "Открыть" | "Файл", и затем найдите и откройте файл. Разверните узел "Таблица строк" и найдите ресурс с идентификатором 3082, его значение должно быть равно "Visual Basic Items". Эту строку нужно поместить в вызов AddNewItem. Точно такая же процедура используется для систем работы с проектами Visual C#, Visual C++ и Visual C#. Единственное отличие: имена файлов и идентификаторы ресурсов отличаются.

Ниже приводится таблица идентификаторов ресурсов и расположений файлов пользовательского интерфейса:

Язык программирования	Имя файла пользовательского интерфейса	Ресурс с идентификатором класса
Visual Basic	…\Program Files\Microsoft Visual Studio 8\VB\Bin\1033\msvbprojUI.dll	3082
Visual C#	…\Program Files\Microsoft Visual Studio 8\VC#\VCSPackages\1033\csprjui.dll	2346
Visual C++	…\Program Files\Microsoft Visual Studio 8\VC\vcpackages\1033\VCProjectUI.dll	10007

Примеры

Sub AddNewItemExample()
   Dim ItemOp As ItemOperations
   ItemOp = DTE.ItemOperations
   ItemOp.AddNewItem("General\Text File", "A new text file")
End Sub

Безопасность платформы .NET Framework

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

См. также

Ссылки

ItemOperations Интерфейс

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

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