CodeEnum.AddMember(String, Object, Object) Méthode

Définition

Crée une construction de code de membre et insère le code à l'emplacement approprié.

EnvDTE::CodeVariable AddMember(std::wstring const & Name, winrt::Windows::Foundation::IInspectable const & Value, winrt::Windows::Foundation::IInspectable const & Position);
[System.Runtime.InteropServices.DispId(61)]
public EnvDTE.CodeVariable AddMember (string Name, object Value, object Position);
[<System.Runtime.InteropServices.DispId(61)>]
abstract member AddMember : string * obj * obj -> EnvDTE.CodeVariable
Public Function AddMember (Name As String, Optional Value As Object, Optional Position As Object) As CodeVariable

Paramètres

Name
String

Obligatoire. Nom du nouveau membre.

Value
Object

Facultatif. InitExpression de l'objet CodeVariable retourné. Il peut être passé sous la forme d'une chaîne ou d'un objet d'expression.

Position
Object

Facultatif. Valeur par défaut = 0. Élément de code après lequel le nouvel élément doit être ajouté. Si la valeur est CodeElement, le nouvel élément est ajouté directement après.

Si la valeur est un type de données Long, AddMember(String, Object, Object) indique l'élément après lequel le nouvel élément doit être ajouté.

Comme la comptabilisation des collections commence à 1, la transmission de la valeur 0 indique que le nouvel élément doit être placé au début de la collection. La valeur -1 signifie que l'élément doit être placé à la fin.

Retours

CodeVariable

Objet CodeVariable.

Attributs

Exemples

Sub AddMemberExample(ByVal dte As DTE2)  

    ' Before running this example, open a code document from a project  
    ' and place the insertion point inside an enumeration.  
    Try  
        ' Retrieve the CodeEnum at the insertion point.  
        Dim sel As TextSelection = _  
            CType(dte.ActiveDocument.Selection, TextSelection)  
        Dim enm As CodeEnum = _  
            CType(sel.ActivePoint.CodeElement( _  
            vsCMElement.vsCMElementEnum), CodeEnum)  

        ' Add a member to the enumeration.  
        enm.AddMember("TestMember")  
    Catch ex As Exception  
        MsgBox(ex.Message)  
    End Try  

End Sub  
public void AddMemberExample(DTE2 dte)  
{  
    // Before running this example, open a code document from a project  
    // and place the insertion point inside an enumeration.  
    try  
    {  
        // Retrieve the CodeEnum at the insertion point.  
        TextSelection sel =   
            (TextSelection)dte.ActiveDocument.Selection;  
        CodeEnum enm =   
            (CodeEnum)sel.ActivePoint.get_CodeElement(  
            vsCMElement.vsCMElementEnum);  

        // Add a member to the enumeration.  
        enm.AddMember("TestMember", null, -1);  
    }  
    catch (Exception ex)  
    {  
        MessageBox.Show(ex.Message);  
    }  
}  

Remarques

AddMember Ajoute un membre à l’énumération et retourne un objet dont la propriété a la CodeVariable IsConstant valeur true .

Lors Value de l’affectation d’une valeur à une chaîne, AddMember insère toute syntaxe requise, telle que des signes égal ou des points-virgules, si la variable n’a pas encore d’expression d’initialisation. Selon les langages et les vérifications syntaxiques ou sémantiques effectués sur la chaîne passée, la définition de cet argument peut échouer. Il n’est pas nécessaire que les langages vérifient la chaîne, et étant donné que la chaîne dépend nécessairement du langage, la définition de cet argument peut entraîner un comportement indéfini si le contenu de la chaîne est incorrect.

Lors de l’affectation de la valeur Value à CodeElement , si le CodeElement doit être créé, dépend de l’implémentation du langage du modèle de code. Certains langages peuvent implémenter la copie de la sémantique si vous transmettez un élément de code qui se trouve déjà dans un fichier source.

L’exactitude des arguments est déterminée par le langage derrière le modèle de code.

Notes

Les valeurs des éléments de modèle de code, tels que les classes, les structures, les fonctions, les attributs, les délégués, ne peuvent pas être utilisées pour rester identiques à tout moment. Pour plus d’informations, consultez la section les valeurs d’élément de modèle de code peuvent changer dans la découverte de code à l’aide du modèle de code (Visual Basic).

S’applique à