CodeDelegate2.AddAttribute - метод (String, String, Object)

Статья
11/05/2008

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

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

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

Синтаксис

'Декларация
Function AddAttribute ( _
    Name As String, _
    Value As String, _
    Position As Object _
) As CodeAttribute
'Применение
Dim instance As CodeDelegate2
Dim Name As String
Dim Value As String
Dim Position As Object
Dim returnValue As CodeAttribute

returnValue = instance.AddAttribute(Name, _
    Value, Position)

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

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

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

Параметры

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

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

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

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

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

Реализации

CodeDelegate.AddAttribute(String, String, Object)

Заметки

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

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

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

Примеры

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

Delegate Sub MySubDelegate(ByVal x As Integer)
public delegate void MySubDelegate(int x);
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

Разрешения

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