Debugger4 介面

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

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

語法

'宣告
<GuidAttribute("133BAD54-8E8D-451B-9DB0-AF38ED9819CC")> _
Public Interface Debugger4 _
    Inherits Debugger3

[GuidAttribute("133BAD54-8E8D-451B-9DB0-AF38ED9819CC")]
public interface Debugger4 : Debugger3

[GuidAttribute(L"133BAD54-8E8D-451B-9DB0-AF38ED9819CC")]
public interface class Debugger4 : Debugger3

[<GuidAttribute("133BAD54-8E8D-451B-9DB0-AF38ED9819CC")>]
type Debugger4 =  
    interface
        interface Debugger3
    end

public interface Debugger4 extends Debugger3

Debugger4 型別會公開下列成員。

屬性

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

回頁首

方法

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

回頁首

備註

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

若要使用 Debugger4，您必須加入 EnvDTE90a.dll 的參考。 若為原生開發，您必須加入 dte90a.tlb 的參考。

範例

請參閱 Debugger3。

請參閱

參考

EnvDTE90a 命名空間