CodeEvent.AddAttribute-Methode

Artikel
05/16/2015

Erstellt ein neues Attributcodekonstrukt und fügt den Code an der korrekten Position ein.

Namespace: EnvDTE80
Assembly: EnvDTE80 (in EnvDTE80.dll)

Syntax

'Declaration
Function AddAttribute ( _
    Name As String, _
    Value As String, _
    Position As Object _
) As CodeAttribute

CodeAttribute AddAttribute(
    string Name,
    string Value,
    Object Position
)

CodeAttribute^ AddAttribute(
    String^ Name, 
    String^ Value, 
    Object^ Position
)

abstract AddAttribute : 
        Name:string * 
        Value:string * 
        Position:Object -> CodeAttribute

function AddAttribute(
    Name : String, 
    Value : String, 
    Position : Object
) : CodeAttribute

Parameter

Name
Typ: String

Der Name des Attributs.

Value
Typ: String

Der Wert des Attributs. Hierbei kann es sich um eine durch Trennzeichen getrennte Liste von Parametern für eine parametrisierte Eigenschaft handeln.

Position
Typ: Object

Optional. Die Position des Elements, nach dem das neue Element hinzugefügt wird.

Wenn der Wert null ist, wird das neue Element am Anfang der Auflistung (Standard) hinzugefügt. Wenn der Wert -1 ist, wird es am Ende hinzugefügt.

Rückgabewert

Typ: CodeAttribute
Ein CodeAttribute-Objekt.

Hinweise

Hinweis

Die Werte von Codemodellelementen wie Klassen, Strukturen, Funktionen, Attributen, Delegaten usw. können nach bestimmten Bearbeitungsvorgängen nicht deterministisch sein, d. h., dass nicht mehr davon ausgegangen werden kann, dass ihre Werte immer unverändert bleiben.Weitere Informationen finden Sie im Abschnitt zum Änderungsverhalten von Codemodellelementwerten unter Ermitteln von Code über das Codemodell (Visual Basic).

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung der AddAttribute-Methode.

So testen Sie diese Eigenschaft

Öffnen Sie das Zielprojekt, und wählen Sie das Codeereigniselement aus, indem Sie den Cursor auf das Ereignisobjekt setzen.
Führen Sie das Add-In aus.

public static void AddAttribute(EnvDTE80.DTE2 dte)
{
    TextSelection objTextSel;
    EnvDTE80.CodeEvent codeEvent;
    objTextSel = (TextSelection)dte.ActiveDocument.Selection;
    codeEvent = (EnvDTE80.CodeEvent)objTextSel.ActivePoint.get_CodeElement(vsCMElement.vsCMElementEvent);

    codeEvent.AddAttribute("Obsolete", "\"NewAttribute\", true", 1);
    string str = "";
    foreach (CodeElement ce in codeEvent.Attributes)
        str += "\n" + ce.FullName;
    MessageBox.Show("\nAddAttribute method: " +
                    str, "Testing CodeEvent");
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.