CodeDelegate2.AddAttribute - метод

Статья
05/17/2015

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

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

Синтаксис

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

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

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

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

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

Параметры

Name
Тип: String

Обязательный. Имя нового атрибута.

Value
Тип: String

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

Position
Тип: Object

Необязательно. Значение по умолчанию: 0 Элемент кода, после которого добавляется новый элемент.

Если Value имеет тип данных LONG, метод AddAttribute указывает, после какого элемента следует добавить новый элемент.

Поскольку в коллекциях нумерация элементов начинается с 1, значение 0 означает, что новый элемент следует поместить в начало коллекции. Значение -1 означает, что элемент следует поместить в конец.

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

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

Заметки

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

Примечание

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

Примеры

Перед запуском данного примера загрузите проект с классом и вставьте следующую строку и код примера. После добавления строки и кода примера щелкните строку Delegate, чтобы установить туда курсор, после чего запустите пример.

[VisualBasic]

Delegate Sub MySubDelegate(ByVal x As Integer)

[C#]

public delegate void MySubDelegate(int x);

[VisualBasic]

Public Sub addDelegateAttribExample(ByVal dte As DTE2)
    Try
        ' Retrieve the CodeClass at the insertion point.
        Dim sel As TextSelection = _
          CType(dte.ActiveDocument.Selection, TextSelection)
        Dim del As CodeDelegate2 = _
          CType(sel.ActivePoint.CodeElement( _
        vsCMElement.vsCMElementDelegate), CodeDelegate2)

        ' Add a new attribute to the delegate.
        del.AddAttribute("someNewAttribute", "someValue", -1)
    Catch ex As System.Exception
        MsgBox(ex.ToString)
    End Try
End Sub

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

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