CodeEnum.AddMember(String, Object, Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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).