CodeEvent.Children - свойство

Статья
08/11/2011

Возвращает коллекцию объектов, содержащихся в данном CodeEvent.

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

Синтаксис

'Декларация
ReadOnly Property Children As CodeElements
    Get

CodeElements Children { get; }

property CodeElements^ Children {
    CodeElements^ get ();
}

abstract Children : CodeElements

function get Children () : CodeElements

Значение свойства

Тип: EnvDTE.CodeElements
Коллекция CodeElements.

Заметки

Если объект CodeEvent не имеет дочерних объектов, то возвращается значение Nothing.

Это свойство главным образом применяется в Visual C++. Свойство Children возвращает каждый объект, возвращаемый из элемента кода. В частности, для класса возвращаются члены, базовые типы, реализуемые интерфейсы, атрибуты, комментарии и т. п.

Children возвращает коллекцию всех связанных объектов CodeElement, к которым можно обратиться с помощью данного элемента кода. Например, для объекта CodeClass к ним могут относиться элементы кода метаданных этого класса и, возможно, спецификации объявлений Visual C++, а также код, созданный с использованием технологии атрибутивного программирования Visual C++, параметры шаблонов и пр. Объект CodeFunction может включать все параметры функции, параметры, предоставляемые с использованием технологии атрибутивного программирования Visual C++, и пр.

Свойство Children может возвращать значение Nothing в зависимости от объекта и языка. Поддержка этого поведения в Visual Studio не является обязательной.

Примечание

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

Примеры

В следующем примере демонстрируется применение свойства Children.

Чтобы проверить это свойство, выполните следующие действия.

Откройте проект и выберите элемент кода события, установив текстовый курсор в объект события.
Запустите надстройку.

public static void Children(EnvDTE80.DTE2 dte)
{
    TextSelection objTextSel;
    EnvDTE80.CodeEvent codeEvent;
    objTextSel = (TextSelection)dte.ActiveDocument.Selection;
    codeEvent = (EnvDTE80.CodeEvent)objTextSel.ActivePoint.get_CodeElement(vsCMElement.vsCMElementEvent);

    MessageBox.Show("\nNumber of Children: " +
        codeEvent.Children.Count, "Testing Children Property");
}

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

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