CodeEvent.Children (Propiedad)

Artículo
08/10/2011

Obtiene una colección de objetos contenidos dentro de CodeEvent.

Espacio de nombres: EnvDTE80
Ensamblado: EnvDTE80 (en EnvDTE80.dll)

Sintaxis

'Declaración
ReadOnly Property Children As CodeElements
    Get

CodeElements Children { get; }

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

abstract Children : CodeElements

function get Children () : CodeElements

Valor de propiedad

Tipo: EnvDTE.CodeElements
Una colección CodeElements.

Comentarios

Si un objeto CodeEvent no tiene elementos secundarios, entonces devuelve Nothing.

Esta propiedad es utilizada principalmente por Visual C++. Children devuelve todos los objetos que puedan devolverse desde un elemento de código. Una clase, por ejemplo, devuelve miembros, bases, interfaces implementadas, atributos, comentarios, etc.

Children devuelve la colección de todos los objetos CodeElement relacionados a los que se pueda hacer referencia a través de este elemento de código. Por ejemplo, para CodeClass, podría incluir los elementos de código de metadatos correspondientes a la clase y quizás también los declspecs de Visual C++, además de código escrito basado en la característica de programación con atributos de Visual C++, parámetros de plantilla, etc. CodeFunction podría incluir todos sus parámetros, los parámetros contribuidos basados en la característica de programación con atributos de Visual C++, etc.

La propiedad Children puede devolver Nothing, dependiendo del objeto y el lenguaje. No es necesario que Visual Studio admita esto último.

Nota

Los valores de los elementos de modelo de código como clases, structs, funciones, atributos, delegados, etc., pueden ser no deterministas una vez realizados determinados tipos de modificaciones; esto significa que no se puede confiar en que sus valores se mantengan siempre igual. Para obtener más información, vea la sección Los valores de elementos de modelo de código pueden cambiar, en Detectar código utilizando el modelo de código (Visual Basic).

Ejemplos

En el siguiente ejemplo se muestra cómo se utiliza la propiedad Children.

Para probar esta propiedad:

Abra el proyecto de destino y seleccione el elemento de evento de código situando el cursor en el objeto de evento pertinente.
Ejecute el complemento.

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");
}

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.