CodeModel.AddAttribute - метод

Статья
08/11/2011

Создает новую конструкцию кода атрибута и вставляет код в нужное место.

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

Синтаксис

'Декларация
Function AddAttribute ( _
    Name As String, _
    Location As Object, _
    Value As String, _
    Position As Object _
) As CodeAttribute

CodeAttribute AddAttribute(
    string Name,
    Object Location,
    string Value,
    Object Position
)

CodeAttribute^ AddAttribute(
    String^ Name, 
    Object^ Location, 
    String^ Value, 
    Object^ Position
)

abstract AddAttribute : 
        Name:string * 
        Location:Object * 
        Value:string * 
        Position:Object -> CodeAttribute

function AddAttribute(
    Name : String, 
    Location : Object, 
    Value : String, 
    Position : Object
) : CodeAttribute

Параметры

Name
Тип: System.String
Обязательный.Имя нового атрибута.

Location
Тип: System.Object
Обязательный.Путь и имя файла для нового атрибута.В зависимости от языка имя файла может быть либо относительным, либо абсолютным по отношению к файлу проекта.Файл добавляется к проекту, если он не является его частью.Если файл не может быть создан и добавлен к проекту, тогда AddAttribute дает сбой.

Value
Тип: System.String
Обязательный.Значение атрибута, которое для свойства с параметрами может представлять собой разделенный запятыми список параметров.

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

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

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

Заметки

Если атрибут уже существует, метод AddAttribute добавляет еще раз. Это может быть неверно для модели атрибутов или языка кода.

Примечание

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

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

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