Proprietà CodeEvent.Children

Articolo
08/11/2011

Ottiene un insieme di oggetti contenuti all'interno di CodeEvent.

Spazio dei nomi: EnvDTE80
Assembly: EnvDTE80 (in EnvDTE80.dll)

Sintassi

'Dichiarazione
ReadOnly Property Children As CodeElements
    Get

CodeElements Children { get; }

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

abstract Children : CodeElements

function get Children () : CodeElements

Valore proprietà

Tipo: EnvDTE.CodeElements
Insieme CodeElements.

Note

Se un oggetto CodeEvent non dispone di elementi figlio, viene restituito Nothing.

La proprietà è utilizzata principalmente in Visual C++. Children restituisce tutti gli oggetti restituibili da un elemento di codice. Una classe, ad esempio, restituisce membri, basi, interfacce implementate, attributi, commenti e così via.

Children restituisce l'insieme di tutti gli oggetti CodeElement correlati a cui è possibile fare riferimento mediante l'elemento di codice. Nel caso di un oggetto CodeClass, ad esempio, possono essere inclusi gli elementi di codice dei metadati per la classe ed eventualmente le declspec di Visual C++, nonché il codice fornito in base alla funzionalità di programmazione con attributi di Visual C++, i parametri dei modelli e così via. Un oggetto CodeFunction può includere tutti i relativi parametri, i parametri forniti in base alla funzionalità di programmazione con attributi di Visual C++ e così via.

La proprietà Children può restituire Nothing a seconda dell'oggetto e del linguaggio. In Visual Studio non è previsto un requisito per il supporto.

Nota

I valori degli elementi del modello di codice, quali classi, strutture, funzioni, attributi, delegati e così via, possono non essere deterministici dopo alcuni tipi di modifiche. Ciò significa che non si può fare affidamento sulla stabilità di tali valori. Per ulteriori informazioni, vedere la sezione Possibile modifica dei valori degli elementi del modello di codice in Individuazione di codice mediante il modello di codice (Visual Basic).

Esempi

Nell'esempio riportato di seguito viene illustrato l'utilizzo della proprietà Children.

Per verificare la proprietà:

Posizionare il cursore sull'oggetto evento per aprire il progetto di destinazione e selezionare l'elemento dell'evento di codice.
Eseguire il componente aggiuntivo.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.