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

Статья
11/01/2012

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

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

Синтаксис

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

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).

Значения элементов модели кода, таких как классы, структуры, функции, атрибуты, делегаты и другие, после внесения некоторых изменений могут оказаться недетерминированными, другими словами, нельзя рассчитывать, что их значения будут всегда оставаться одинаковыми.Дополнительные сведения см. в разделе "Значения элементов модели кода могут изменяться" в разделе Практическое руководство. Поиск кода при помощи модели кода (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

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