Metodo Engines.Item

Articolo
08/11/2011

Ottiene un membro indicizzato di un insieme Engines.

Spazio dei nomi: EnvDTE80
Assembly: EnvDTE80 (in EnvDTE80.dll)

Sintassi

'Dichiarazione
Function Item ( _
    index As Object _
) As Engine

Engine Item(
    Object index
)

Engine^ Item(
    [InAttribute] Object^ index
)

abstract Item : 
        index:Object -> Engine

function Item(
    index : Object
) : Engine

Parametri

index
Tipo: System.Object

Valore restituito

Tipo: EnvDTE80.Engine
Un oggetto Engine.

Note

Il valore per Index può essere:

BSTR che rappresenta le prime lettere del nome completo del modulo.
BSTR che rappresenta il GUID del modulo.
Valore integer in base 1

Il metodo Item genera un'eccezione ArgumentException se l'insieme non riesce a trovare l'oggetto corrispondente al valore di indice.

Nota

Quando si registra una macro associandovi un processo di debug mediante il modulo di gestione di debug T-SQL, la macro restituisce due riferimenti distinti allo stesso nome di modulo. Ad esempio, dbgeng(0) = transprt.Engines.Item("T-SQL") e dbgeng(1) = transprt.Engines.Item("T-SQL"). Ciò è possibile perché esistono in realtà due motori di debug T-SQL sottostanti in Visual Studio: uno per il motore SQL Server 2005, l'altro per il motore T-SQL per SQL Server 2000 e SQL Server 7. Automaticamente viene fatto riferimento a entrambi durante l'associazione a un processo di motore di debug attraverso la UI, ma nel codice di automazione è necessario fare riferimento a ognuno mediante l'identificatore univoco GUID. Il GUID per SQL Server 2005 è {1202F5B4-3522-4149-BAD8-58B2079D704F}, mentre il GUID per il modulo di gestione di debug T-SQL per SQL Server 2000 e SQL Server 7 è {5AF6F83C-B555-11D1-8418-00C04FA302A1}. Quindi, le suddette chiamate devono essere modificate rispettivamente in dbgeng(0) = trans.Engines.Item("{1202F5B4-3522-4149-BAD8-58B2079D704F}") edbgeng(1) = trans.Engines.Item("{1202F5B4-3522-4149-BAD8-58B2079D704F}").

Esempi

' Macro code.
Imports EnvDTE
Imports EnvDTE80
Imports System.Diagnostics
Imports Microsoft.VisualBasic.ControlChars

Public Module Module1

    Sub ShowDefaultEngines()
        Dim dbg As EnvDTE80.Debugger2
        dbg = DTE.Debugger

        dbg.HexDisplayMode = True

        Dim transport As EnvDTE80.Transport
        transport = dbg.Transports.Item("default")

        Dim engine As EnvDTE80.Engine
        Dim strEngineList As String
        For Each engine In transport.Engines
            strEngineList = strEngineList + engine.Name + ", " + _
            engine.ID + ", " + engine.AttachResult.ToString + NewLine
        Next
        MsgBox(strEngineList)
    End Sub
End Module

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

Engines Interfaccia

Spazio dei nomi EnvDTE80

Condividi tramite