ItemOperations.AddNewItem - метод

Статья
11/05/2008

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

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

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

Синтаксис

'Декларация
Function AddNewItem ( _
    Item As String, _
    Name As String _
) As ProjectItem
'Применение
Dim instance As ItemOperations
Dim Item As String
Dim Name As String
Dim returnValue As ProjectItem

returnValue = instance.AddNewItem(Item, _
    Name)

ProjectItem AddNewItem(
    string Item,
    string Name
)

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

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

Параметры

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

Name
Тип: System.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
JScript	…\Program Files\Microsoft Visual Studio 8\VJ#\bin\1033\vjsprojui.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

Разрешения

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

См. также

Ссылки

ItemOperations Интерфейс

ItemOperations - члены

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

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