CodeClass.AddAttribute(String, String, 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 d'attribut et insère le code à l'emplacement approprié.
EnvDTE::CodeAttribute AddAttribute(std::wstring const & Name, std::wstring const & Value, winrt::Windows::Foundation::IInspectable const & Position);
[System.Runtime.InteropServices.DispId(40)]
public EnvDTE.CodeAttribute AddAttribute (string Name, string Value, object Position);
[<System.Runtime.InteropServices.DispId(40)>]
abstract member AddAttribute : string * string * obj -> EnvDTE.CodeAttribute
Public Function AddAttribute (Name As String, Value As String, Optional Position As Object) As CodeAttribute
Paramètres
- Name
- String
Obligatoire. Nom du nouvel attribut.
- Value
- String
Obligatoire. Valeur de l'attribut. Il peut s'agir d'une liste de paramètres d'une propriété paramétrable séparés par des virgules.
- 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 de type Long, AddAttribute(String, String, 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 CodeAttribute.
- Attributs
Exemples
Sub AddAttributeExample(ByVal dte As DTE2)
' Before running this example, open a code document from a project
' and place the insertion point inside a class definition.
Try
' Retrieve the CodeClass at the insertion point.
Dim sel As TextSelection = _
CType(dte.ActiveDocument.Selection, TextSelection)
Dim cls As CodeClass = _
CType(sel.ActivePoint.CodeElement( _
vsCMElement.vsCMElementClass), CodeClass)
' Add an attribute to the class.
cls.AddAttribute("TestAttribute", "TestValue")
Catch ex As Exception
MsgBox(ex.Message)
End Try
End Sub
public void AddAttributeExample(DTE2 dte)
{
// Before running this example, open a code document from a project
// and place the insertion point inside a class definition.
try
{
// Retrieve the CodeClass at the insertion point.
TextSelection sel =
(TextSelection)dte.ActiveDocument.Selection;
CodeClass cls =
(CodeClass)sel.ActivePoint.get_CodeElement(
vsCMElement.vsCMElementClass);
// Add an attribute to the class.
cls.AddAttribute("TestAttribute", "TestValue", -1);
}
catch (Exception ex)
{
MessageBox.Show(ex.Message);
}
}
Remarques
Si l’attribut existe déjà, en AddAttribute ajoute un autre. Cela peut être incorrect pour l’attribut ou le langage derrière le modèle de code.
Notes
Les valeurs d'éléments de modèle de code, tels que des classes, des structures, des fonctions, des attributs, des délégués, etc., peuvent être non déterministes après certains types de modifications, ce qui signifie qu'il n'est pas certain que leurs valeurs resteront inchangées. 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).