Debugger5 介面

Debugger5 是用來質詢和管理偵錯工具以及要進行偵錯之程式的狀態。 Debugger5 會取代 Debugger4 介面。

命名空間：  EnvDTE100
組件：  EnvDTE100 (在 EnvDTE100.dll 中)

語法

'宣告
<GuidAttribute("C8BBAA3A-7E99-4630-942C-570F085141EB")> _
Public Interface Debugger5 _
    Inherits Debugger4

[GuidAttribute("C8BBAA3A-7E99-4630-942C-570F085141EB")]
public interface Debugger5 : Debugger4

[GuidAttribute(L"C8BBAA3A-7E99-4630-942C-570F085141EB")]
public interface class Debugger5 : Debugger4

[<GuidAttribute("C8BBAA3A-7E99-4630-942C-570F085141EB")>]
type Debugger5 =  
    interface 
        interface Debugger4 
    end

public interface Debugger5 extends Debugger4

Debugger5 類型會公開下列成員。

屬性

	名稱	描述
	AllBreakpointsLastHit	取得最後一次同時叫用的繫結中斷點集合。
	BreakpointLastHit	取得最後一次叫用的中斷點。若要取得同時叫用的多重中斷點集合，請參閱 AllBreakpointsLastHit。
	Breakpoints	取得中斷點集合。
	CurrentMode	傳回 IDE 內容中偵錯工具目前的模式。
	CurrentProcess	取得或設定現用的處理序。
	CurrentProgram	設定或傳回現用的程式。
	CurrentStackFrame	取得或設定目前的堆疊框架 (Stack Frame)。
	CurrentThread	取得或設定目前正在偵錯的執行緒。
	DebuggedProcesses	取得目前正在進行偵錯的處理序清單。
	DTE	取得最上層的擴充性物件。
	ExceptionGroups	取得偵錯工具的例外狀況 (Exception) 設定。對於每個例外狀況而言，這些設定會決定偵錯工具是否會先讓程式碼處理例外狀況，再讓偵錯工具中斷執行。
	ForceContinue	取得或設定值，這個值會決定當追蹤點或中斷點執行巨集完成時，偵錯工具要中斷或繼續執行。建立追蹤點或中斷點時，使用者必須在對話方塊中設定預設的行為。這個屬性可用來變更此預設行為。
	HexDisplayMode	取得或設定值，這個值表示運算式是以十六進位格式輸出，還是以十進位格式輸出。
	HexInputMode	取得或設定值，這個值表示運算式是以十六進位格式來評估，還是以十進位格式來評估。
	Languages	取得偵錯工具所支援的語言清單。
	LastBreakReason	取得最後一次程式中斷的原因。如果程式正在執行中，它會傳回 DBG_REASON_NONE。
	LocalProcesses	取得這部電腦上目前正在執行的處理序清單。
	OnlyLoadSymbolsManually	取得值，這個值會判斷要手動或自動載入符號。Visual Studio 使用者可以在 [選項] 對話方塊中決定此項設定。如需如何使用 Visual Studio 設定這個值的詳細資訊，請參閱 [OBSOLETE] 如何：指定符號位置和載入行為。
	Parent	取得直屬父物件 (DTE)。
	SymbolCachePath	取得字串，其中包含當您從符號伺服器下載符號時，Visual Studio 使用的符號快取區路徑。您可以在 [選項] 對話方塊中指定符號快取區路徑。如需詳細資訊，請參閱[OBSOLETE] 如何：使用符號伺服器。
	SymbolPath	取得字串，包含 Visual Studio 在進行偵錯時使用的 .PDB 符號檔路徑。Visual Studio 使用者可以在 [選項] 對話方塊中指定符號路徑。如需詳細資訊，請參閱 [OBSOLETE] 如何：指定符號位置和載入行為。
	SymbolPathState	取得字串，這個字串表示 Visual Studio 在進行偵錯時使用之 .PDB 符號檔的所有符號路徑狀態。
	Transports	取得所支援的偵錯傳輸集合。

回頁首

方法

	名稱	描述
	Break	使指定的處理序暫停執行，如此才能分析其目前的狀態。
	DeleteObjectID	刪除物件 ID。
	DetachAll	從所有附加的程式中斷連結。
	ExecuteStatement	執行指定的陳述式。如果 TreatAsExpression 旗標為 true，則字串會解譯成運算式，而且輸出會傳送到 命令視窗。
	ExportBreakpoints	將中斷點匯出至檔案。
	GetExpression	基於目前堆疊框架評估運算式。如果運算式可以剖析但無法評估，則將會傳回物件，但它不包含有效值。
	GetExpression2	基於目前堆疊框架評估運算式。如果運算式可以剖析但無法評估，則將會傳回物件，但它不包含有效值。此方法與 GetExpression 類似，但是具有額外的布林值參數，該參數可設為 true，表示運算式要評估為陳述式。
	GetExpression3	會評估運算式，類似於 GetExpression。不過，這個方法可讓呼叫端指定將進行評估的堆疊框架 (Stack Frame)，也能讓呼叫端指定是否要自動評估屬性及隱含函式呼叫。
	GetProcesses	取得物件，這個物件表示目前已在指定的傳輸上連線，以進行偵錯的處理序。
	Go	從目前的陳述式開始執行程式。
	ImportBreakpoints	從檔案匯入中斷點。
	RunToCursor	執行程式至原始程式檔游標目前的位置。
	SetNextStatement	根據游標在目前原始程式檔中的位置，設定下一個要執行的指令。
	SetSymbolSettings	設定 Visual Studio 在偵錯時使用之 .PDB 符號的各種設定，並強制重新載入所有符號。
	StepInto	如果可以，逐步執行下一個函式呼叫。
	StepOut	跳出目前的函式。
	StepOver	不進入下一個函式呼叫。
	Stop	停止偵錯並且終止所有附加的處理序或中斷它們的連結。
	TerminateAll	結束目前正在執行的所有偵錯處理序。
	WriteMinidump	如果這個函式是在中斷模式中偵錯某一程式，那麼它將建立目前偵錯工作階段的小型傾印 (Minidump)。

回頁首

備註

偵錯工具可以透過 DTE2 物件的Debugger 屬性來使用。(您必須將此物件轉換為 Debugger5。 「整合式開發環境」(Integrated Development Environment，IDE) 的每個執行個體都有一個偵錯工具物件。

若要使用 Debugger5，您必須加入 EnvDTE100.dll 的參考。 若為原生開發，您必須加入 dte100.tlb 的參考。

請參閱

參考

EnvDTE100 命名空間