Expressions.Item-Methode

Artikel
05/16/2015

Gibt ein Expression-Objekt in einer Expressions-Auflistung zurück.

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

Syntax

'Declaration
Function Item ( _
    index As Object _
) As Expression

Expression Item(
    Object index
)

Expression^ Item(
    [InAttribute] Object^ index
)

abstract Item : 
        index:Object -> Expression

function Item(
    index : Object
) : Expression

Parameter

index
Typ: Object

Erforderlich. Der Index des zurückzugebenden Expression-Objekts.

Rückgabewert

Typ: EnvDTE.Expression
Ein Expression-Objekt.

Hinweise

Die Item-Methode löst eine System.ArgumentException-Ausnahme aus, wenn die Auflistung das dem Indexwert entsprechende Objekt nicht finden kann.

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung der Item-Methode.

So testen Sie diese Methode

Die Zielanwendung muss eine Klasse A enthalten. Die Main-Funktion muss eine Instanz einer Klasse A mit dem Namen "a" erstellen.
Legen Sie in der Main-Funktion einen Haltepunkt fest, nachdem eine Instanz der Klasse A erstellt und die zugehörigen Membervariablen initialisiert wurden.
Führen Sie die Zielanwendung im Debugmodus aus.
Führen Sie das Add-In aus, wenn die Anwendung am Haltepunkt hält.

public static void Item(DTE dte)
{
    // Setup debug Output window.
    Window w = (Window)dte.Windows.Item(EnvDTE.Constants.vsWindowKindOutput);
    w.Visible = true;
    OutputWindow ow = (OutputWindow)w.Object;
    OutputWindowPane owp = ow.OutputWindowPanes.Add("Item Method Test");
    owp.Activate();

    EnvDTE.Expression exp = dte.Debugger.GetExpression("a", true, 1);
    EnvDTE.Expressions exps = exp.DataMembers;
    owp.OutputString("\nExpression count: " + exps.Count);
    owp.OutputString("\nEdition of the environment: " + exps.DTE.Edition);
    owp.OutputString("\nThe name of the current program: " + 
                     exps.Parent.CurrentProgram.Name);
    owp.OutputString("\nSecond expression: " + exps.Item(2).Name);
}

Shared Sub Item(ByRef dte As EnvDTE.DTE)
    Dim exp As EnvDTE.Expression = dte.Debugger.GetExpression("a", True, 1)
    Dim exps As EnvDTE.Expressions = exp.DataMembers
    Dim str As String = vbCrLf
    str = "Expression count: " + exps.Count.ToString()
    str += vbCrLf + "Edition of the environment: " + exps.DTE.Edition
    str += vbCrLf + "The name of the current program: " + _
           exps.Parent.CurrentProgram.Name
    str += vbCrLf + "Second expression: " + exps.Item(2).Name
    MessageBox.Show(str, "Expression Test - Expressions Properties")
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.

Siehe auch

Referenz

Expressions Schnittstelle

EnvDTE-Namespace

Weitere Ressourcen

Gewusst wie: Kompilieren und Ausführen der Codebeispiele für das Automatisierungsobjektmodell

Freigeben über