CodeDelegate2.AddParameter-Methode (String, Object, Object)

Artikel
08/10/2011

Erstellt einen neuen Parameter für den Delegaten und fügt den Code an der korrekten Position ein.

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

Syntax

'Declaration
Function AddParameter ( _
    Name As String, _
    Type As Object, _
    Position As Object _
) As CodeParameter

CodeParameter AddParameter(
    string Name,
    Object Type,
    Object Position
)

CodeParameter^ AddParameter(
    String^ Name, 
    Object^ Type, 
    Object^ Position
)

abstract AddParameter : 
        Name:string * 
        Type:Object * 
        Position:Object -> CodeParameter

function AddParameter(
    Name : String, 
    Type : Object, 
    Position : Object
) : CodeParameter

Parameter

Name
Typ: System.String
Erforderlich.Der Name des Parameters.

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, hinter dem der Parameter hinzugefügt werden soll.Wenn Value ein CodeElement darstellt, wird das neue Element unmittelbar im Anschluss hinzugefügt.
Wenn Value ein Long-Datentyp ist, gibt AddParameter das Element an, hinter 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: EnvDTE.CodeParameter
Ein CodeParameter-Objekt.

Implementiert

CodeDelegate.AddParameter(String, Object, Object)

Hinweise

Für vollqualifizierte Typnamen in Visual C++ ist ein Doppelpunkt (::) als Trennzeichen erforderlich; alle anderen Programmiersprachen unterstützen Punkte als Trennzeichen.

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

Tipp

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

Laden Sie vor dem Ausführen des Beispiels ein Projekt mit einer Klasse, und fügen Sie mit dem Beispielcode die folgende Zeile ein. Klicken Sie nach dem Hinzufügen der Zeile und des Beispielcodes auf die Delegate-Zeile, um die Einfügemarke an dieser Stelle zu positionieren, und führen Sie dann das Beispiel aus.

[VisualBasic]

Delegate Sub MySubDelegate(ByVal x As Integer)

[C#]

public delegate void MySubDelegate(int x);

[VisualBasic]

Public Sub addDelegateParamExample(ByVal dte As DTE2)
    Try
        ' Retrieve the CodeClass at the insertion point.
        Dim sel As TextSelection = _
          CType(dte.ActiveDocument.Selection, TextSelection)
        Dim del As CodeDelegate2 = _
          CType(sel.ActivePoint.CodeElement( _
        vsCMElement.vsCMElementDelegate), CodeDelegate2)

       ' Add a new parameter to the delegate.
       del.AddParameter("someNewBase", "Solution2", -1)
    Catch ex As System.Exception
        MsgBox(ex.ToString)
    End Try
End Sub

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