VCCodeEnum.AddMember-Methode

Artikel
05/16/2015

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

Namespace: Microsoft.VisualStudio.VCCodeModel
Assembly: Microsoft.VisualStudio.VCCodeModel (in Microsoft.VisualStudio.VCCodeModel.dll)

Syntax

'Declaration
Function AddMember ( _
    Name As String, _
    Value As Object, _
    Position As Object _
) As CodeVariable

CodeVariable AddMember(
    string Name,
    Object Value,
    Object Position
)

CodeVariable^ AddMember(
    String^ Name, 
    Object^ Value, 
    Object^ Position
)

abstract AddMember : 
        Name:string * 
        Value:Object * 
        Position:Object -> CodeVariable

function AddMember(
    Name : String, 
    Value : Object, 
    Position : Object
) : CodeVariable

Parameter

Name
Typ: String

Erforderlich. Der Name des neuen Members.

Value
Typ: Object

Optional. Es wird die InitExpression des CodeVariable-Objekts zurückgegeben. Dies kann entweder als Zeichenfolge oder als Ausdrucksobjekt übergeben werden.

Position
Typ: Object

Optional. Standardwert = 0. Das Codeelement, hinter dem das neue Element hinzugefügt werden soll. Wenn der Wert ein CodeElement ist, wird das neue Element unmittelbar im Anschluss hinzugefügt.

Wenn der Wert ein Long-Datentyp ist, gibt AddMember das Element an, nach dem das neue Element hinzugefügt werden soll.

Da die Zählung bei Auflistungen mit 1 beginnt, wird mit dem Wert 0 angegeben, dass das neue Element am Anfang der Auflistung eingefügt werden soll. Bei dem Wert -1 wird das Element am Ende eingefügt.

Rückgabewert

Typ: CodeVariable
Ein CodeVariable-Objekt.

Hinweise

AddMember fügt der Enumeration einen Member hinzu und gibt ein CodeVariable-Objekt zurück, dessen IsConstant-Eigenschaft auf true festgelegt ist.

Wenn Value auf eine Zeichenfolge festlegen, fügt AddMember jede erforderliche Syntax, wie Gleichheitszeichen oder Semikolons ein, wenn die Variable nicht bereits einen Initialisierungsausdruck hat. Abhängig von den Sprachen und allen oder syntaktischen Semantik- Überprüfungen, die sie mit der übergebenen Zeichenfolge ausgeführt wird und Argument legt dieses fest, kann fehlschlagen. Sprachen müssen die Zeichenfolge nicht prüfen. Da diese jedoch immer sprachspezifisch ist, kann das Festlegen des Arguments ein undefiniertes Verhalten zur Folge haben, wenn der Inhalt der Zeichenfolge nicht korrekt formatiert wurde.

Wenn sie Value auf CodeElement festlegt, hängt die Entscheidung, ob CodeElement neu erstellt sein muss, von der Sprachenimplementierung des Codemodells ab. Einige Sprachen implementieren ggf. das Kopieren von Semantik, wenn Sie ein bereits in einer Quelldatei vorhandenes Codeelement übergeben.

Die Gültigkeit der Argumente wird durch die Sprache des Codemodells bestimmt.

.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.