CodeModel.AddVariable-Methode

Článek
08/23/2008

Aktualisiert: November 2007

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

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

Syntax

'Declaration
Function AddVariable ( _
    Name As String, _
    Location As Object, _
    Type As Object, _
    Position As Object, _
    Access As vsCMAccess _
) As CodeVariable
'Usage
Dim instance As CodeModel
Dim Name As String
Dim Location As Object
Dim Type As Object
Dim Position As Object
Dim Access As vsCMAccess
Dim returnValue As CodeVariable

returnValue = instance.AddVariable(Name, _
    Location, Type, Position, Access)

CodeVariable AddVariable(
    string Name,
    Object Location,
    Object Type,
    Object Position,
    vsCMAccess Access
)

CodeVariable^ AddVariable(
    String^ Name, 
    Object^ Location, 
    Object^ Type, 
    Object^ Position, 
    vsCMAccess Access
)

function AddVariable(
    Name : String, 
    Location : Object, 
    Type : Object, 
    Position : Object, 
    Access : vsCMAccess
) : CodeVariable

Parameter

Name
Typ: System.String

Erforderlich. Der Name der neuen Variablen.

Location
Typ: System.Object

Optional. Der Pfad- und Dateiname für die neue Variablendefinition. Je nach Programmiersprache wird der Dateiname entweder relativ oder absolut zur Projektdatei angegeben. Die Datei wird dem Projekt hinzugefügt, wenn sie nicht bereits als Projektelement vorhanden ist. Wenn die Datei nicht erstellt und dem Projekt nicht hinzugefügt werden kann, schlägt AddVariable fehl.

Type
Typ: System.Object

Erforderlich. Eine vsCMTypeRef-Konstante, die den von der Funktion zurückgegebenen Datentyp angibt. Dies kann ein CodeTypeRef-Objekt, eine vsCMTypeRef-Konstante oder ein vollqualifizierter Typname sein.

Position
Typ: System.Object

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

Wenn der Wert ein Long-Datentyp ist, gibt AddVariable 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 einem Wert von -1 wird das Element am Ende eingefügt.

Access
Typ: EnvDTE.vsCMAccess

Optional. Eine vsCMAccess-Konstante.

Rückgabewert

Typ: EnvDTE.CodeVariable

Ein CodeVariable-Objekt.

Hinweise

Im systemeigenen Visual C++ ist ein doppelter Doppelpunkt (::) als Trennzeichen für vollqualifizierte Typnamen erforderlich. Alle anderen Programmiersprachen unterstützen das durch Punkte getrennte Format.

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

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

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

Berechtigungen

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.