CodeStruct.AddBase - метод

Статья
11/05/2008

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

Добавляет элемент в список унаследованных объектов.

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

Синтаксис

'Декларация
Function AddBase ( _
    Base As Object, _
    Position As Object _
) As CodeElement
'Применение
Dim instance As CodeStruct
Dim Base As Object
Dim Position As Object
Dim returnValue As CodeElement

returnValue = instance.AddBase(Base, Position)

CodeElement AddBase(
    Object Base,
    Object Position
)

CodeElement^ AddBase(
    Object^ Base, 
    Object^ Position
)

function AddBase(
    Base : Object, 
    Position : Object
) : CodeElement

Параметры

Base
Тип: System.Object
Обязательный. Класс, производной от которого является реализация.
Для объектов CodeClass это может быть либо объект CodeClass, либо полное имя типа. Для полных имен типов в Visual C++ необходимо использовать формат с разделителем в виде двух двоеточий (::). Все остальные языки поддерживают формат с разделителем-точкой.
Для объектов CodeEnumBase представляет собой значение типа Variant, содержащее полное имя типа или объект CodeType, на котором будет основано новое перечисление. В C# это базовый тип перечисления.

Position
Тип: System.Object
Необязательный. По умолчанию = 0. Элемент кода, после которого вставляется новый элемент. Если значение CodeElement, новый элемент добавляется непосредственно после него.
Если значение имеет тип данных Long, AddBase указывает, после какого элемента следует добавить новый элемент.
Поскольку в коллекциях нумерация элементов начинается с 1, значение 0 означает, что новый элемент следует поместить в начало коллекции. Значение -1 означает, что элемент следует поместить в конец.

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

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

Заметки

Правильность аргументов определяется языком модели кода. AddBase приводит к ошибке для объектов Visual J# CodeClass, если имеется уже объявленный базовый класс. Необходимо сначала удалить существующий класс с помощью CodeType.RemoveBase.

AddBase возвращает объект CodeElement, а не CodeType для совместимости с Visual C++ .NET, и свойство Kind возвращаемого объекта равно vsCMElementVCBase для реализации Visual C++ .NET.

Примечание.
Значения элементов модели кода, таких как классы, структуры, функции, атрибуты, делегаты и другие, после внесения некоторых изменений могут оказаться недетерминированными, другими словами, нельзя рассчитывать, что их значения будут всегда оставаться одинаковыми. Дополнительные сведения см. в разделе "Значения элементов модели кода могут изменяться" раздела Практическое руководство. Поиск кода при помощи модели кода (Visual Basic).

Значения элементов модели кода, таких как классы, структуры, функции, атрибуты, делегаты и другие, после внесения некоторых изменений могут оказаться недетерминированными, другими словами, нельзя рассчитывать, что их значения будут всегда оставаться одинаковыми. Дополнительные сведения см. в разделе "Значения элементов модели кода могут изменяться" раздела Практическое руководство. Поиск кода при помощи модели кода (Visual Basic).

Разрешения

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