Método Engines.Item

Artigo
10/26/2012

Obtém um membro indexado de um Engines coleção.

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

Sintaxe

'Declaração
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

Parâmetros

index
Tipo: System.Object

Valor de retorno

Tipo: EnvDTE80.Engine
A Engine object.

Comentários

O valor de Index pode ser:

Um BSTR representando as primeiras letras do nome completo do mecanismo.
Um BSTR, que representa o GUID do mecanismo.
Um valor inteiro baseado em 1

O Item método lança um ArgumentException exceção se a coleção não é possível localizar o objeto que corresponde ao valor de índice.

Observação
Quando você grava uma macro e anexa a um processo de depuração usando o mecanismo de depuração T-SQL, a macro retorna duas referências separadas para o mesmo nome do mecanismo.For example, dbgeng(0) = transprt.Engines.Item("T-SQL") and dbgeng(1) = transprt.Engines.Item("T-SQL").Isso acontece porque há realmente dois subjacentes T-SQL depuração mecanismos em Visual Studio: um para o SQL Server 2005 mecanismo de depuração, outro para a depuração do T-SQL engine para 2000 de SQL Server e 7 do SQL Server.Eles são automaticamente referenciados ao anexar a um processo de mecanismo de depuração através da interface do usuário, mas no código de automação, eles devem cada ser referenciados usando seu identificador exclusivo GUID.O GUID de SQL Server 2005 é {1202F5B4-3522-4149-BAD8-58B2079D704F}, e o GUID para o mecanismo de depuração T-SQL para 2000 de SQL Server e 7 do SQL Server é {5AF6F83C-B555-11D1-8418-00C04FA302A1}.Para que as chamadas acima devem ser alteradas para dbgeng(0) = trans.Engines.Item("{1202F5B4-3522-4149-BAD8-58B2079D704F}") e dbgeng(1) = trans.Engines.Item("{1202F5B4-3522-4149-BAD8-58B2079D704F}") respectivamente.

Quando você grava uma macro e anexa a um processo de depuração usando o mecanismo de depuração T-SQL, a macro retorna duas referências separadas para o mesmo nome do mecanismo.For example, dbgeng(0) = transprt.Engines.Item("T-SQL") and dbgeng(1) = transprt.Engines.Item("T-SQL").Isso acontece porque há realmente dois subjacentes T-SQL depuração mecanismos em Visual Studio: um para o SQL Server 2005 mecanismo de depuração, outro para a depuração do T-SQL engine para 2000 de SQL Server e 7 do SQL Server.Eles são automaticamente referenciados ao anexar a um processo de mecanismo de depuração através da interface do usuário, mas no código de automação, eles devem cada ser referenciados usando seu identificador exclusivo GUID.O GUID de SQL Server 2005 é {1202F5B4-3522-4149-BAD8-58B2079D704F}, e o GUID para o mecanismo de depuração T-SQL para 2000 de SQL Server e 7 do SQL Server é {5AF6F83C-B555-11D1-8418-00C04FA302A1}.Para que as chamadas acima devem ser alteradas para dbgeng(0) = trans.Engines.Item("{1202F5B4-3522-4149-BAD8-58B2079D704F}") e dbgeng(1) = trans.Engines.Item("{1202F5B4-3522-4149-BAD8-58B2079D704F}") respectivamente.

Exemplos

' 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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Engines Interface

Namespace EnvDTE80

Compartilhar via