Engine インターフェイス

更新 : 2007 年 11 月

コード型への割り当てに使用されるデバッグ エンジンです。

名前空間 :  EnvDTE80
アセンブリ :  EnvDTE80 (EnvDTE80.dll 内)

構文

'宣言
<GuidAttribute("8CEA6D39-EBEE-4DE9-B282-B5CECE9C9861")> _
Public Interface Engine
'使用
Dim instance As Engine

[GuidAttribute("8CEA6D39-EBEE-4DE9-B282-B5CECE9C9861")]
public interface Engine

[GuidAttribute(L"8CEA6D39-EBEE-4DE9-B282-B5CECE9C9861")]
public interface class Engine

public interface Engine

解説

デバッガでコードに基づいてデバッグする方法を決める場合に使用されます。これは、[プロセスにアタッチ] ウィンドウに対応しています。

Engine オブジェクトは、特定のプロセスでデバッグの対象となるプログラムの種類を指定する場合に使用されます。たとえば、プロセス内のマネージ コードだけをデバッグする場合、"Common Language Runtime" デバッグ エンジンを使用してプロセスにアタッチします。プロセスのマネージ コードとアンマネージ コードの両方をデバッグする場合は、"Interop COM+" エンジンでアタッチします。

メモ :

マクロを記録し、T-SQL デバッグ エンジンを使用してデバッグ プロセスにアタッチすると、そのマクロは同じエンジン名に対して 2 つの個別の参照を返します。たとえば、dbgeng(0) = transprt.Engines.Item("T-SQL") や dbgeng(1) = transprt.Engines.Item("T-SQL") などです。これは、実際には 2 つの基底の T-SQL デバッグ エンジン (一方は SQL Server 2005 デバッグ エンジン用で、他方は SQL Server 2000 と SQL Server 7 の T-SQL デバッグ エンジン用) が Visual Studio に存在するためです。いずれも、UI を介してデバッグ エンジン プロセスにアタッチするときに自動的に参照されます。ただし、オートメーション コードでは、各デバッグ エンジンは、一意の識別子 GUID を使用して参照される必要があります。SQL Server 2005 の GUID は {1202F5B4-3522-4149-BAD8-58B2079D704F} で、SQL Server 2000 と SQL Server 7 の T-SQL デバッグ エンジンの GUID は {5AF6F83C-B555-11D1-8418-00C04FA302A1} です。したがって、上記の呼び出しは、それぞれ dbgeng(0) = trans.Engines.Item("{1202F5B4-3522-4149-BAD8-58B2079D704F}") と dbgeng(1) = trans.Engines.Item("{1202F5B4-3522-4149-BAD8-58B2079D704F}") に変更する必要があります。

例

' 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

参照

参照

Engine メンバ

EnvDTE80 名前空間

Engines