DkmPendingDataBreakpoint 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
系結至數據表達式而非程式代碼表達式的擱置斷點。 寫入指定的專案時,會引發數據斷點。
public ref class DkmPendingDataBreakpoint : Microsoft::VisualStudio::Debugger::Breakpoints::DkmPendingBreakpoint
[System.Runtime.InteropServices.Guid("afd7a281-dbf3-946b-9464-8ca12287616b")]
public class DkmPendingDataBreakpoint : Microsoft.VisualStudio.Debugger.Breakpoints.DkmPendingBreakpoint
[<System.Runtime.InteropServices.Guid("afd7a281-dbf3-946b-9464-8ca12287616b")>]
type DkmPendingDataBreakpoint = class
inherit DkmPendingBreakpoint
Public Class DkmPendingDataBreakpoint
Inherits DkmPendingBreakpoint
- 繼承
- 繼承
- 屬性
屬性
CompilerId |
識別來源語言 (例如:C#) 和編譯程式廠商 (,例如:Microsoft) 斷點應該系結的來源語言。 'LanguageId' 可能保留為 Guid.Empty,表示斷點應該系結至所有語言。 'VendorId' 幾乎一律保留為 Guid.Empty,這表示只有已知語言 (不是編譯程式) 。 (繼承來源 DkmPendingBreakpoint) |
DataElementLocation |
指出要 watch 的數據值位置。 |
IsBarrier |
指出此斷點是否為應在硬體上設定的屏障,這適用於 GPU 偵錯。 (繼承來源 DkmPendingBreakpoint) |
IsUnloaded |
如果已針對這個對象引發 'unloaded' 事件,則傳回 true (範例:DkmThread::Unload 會呼叫) 或物件已關閉。 請注意,檢查此狀態時必須小心,而不進行同步處理,傳回的狀態在讀取之後可能無法再精確指示。 (繼承來源 DkmDataContainer) |
Process |
DkmProcess 代表正在偵錯的目標進程。 調試程式會偵錯進程,因此這是偵錯的基本單位。 DkmProcess 可以代表系統進程或虛擬進程,例如minidumps。 (繼承來源 DkmPendingBreakpoint) |
Size |
指定要監視存取的位置大小,以位元組為單位。 有效大小可能取決於目標處理器 (x86、x64 等) 和正在偵錯的程式代碼類型。 例如,原生程式代碼會利用CPU的斷點緩存器,而 x86 型處理器支援1、2和4的大小。 |
SourceId |
識別物件的來源。 SourceId 可用來在多個元件可能建立類別實例的案例中啟用篩選。 例如,來源標識碼可用來判斷斷點是否來自AD7 AL (,例如:用戶斷點,或SDM層級可見的其他斷點) ,而不是由另一個元件所建立的斷點 (,例如用於逐步執行) 的內部斷點。 (繼承來源 DkmPendingBreakpoint) |
TagValue |
DkmPendingBreakpoint 是抽象基類。 這個列舉表示這個物件的衍生類別是的實例。 (繼承來源 DkmPendingBreakpoint) |
Thread |
[選擇性]這個斷點應該引發的線程。 如果為 null,斷點將會在所有線程上引發。 (繼承來源 DkmPendingBreakpoint) |
UniqueId |
可唯一識別這個擱置斷點物件的 Guid。 (繼承來源 DkmPendingBreakpoint) |
方法
Close() |
關閉 DkmPendingBreakpoint 物件實例。 這會釋放所有元件上與此對象相關聯的任何資源。 這包括跨計算機或受控/原生封送處理界限的資源。 關閉相關聯的 DkmProcess 物件時,會自動關閉 DkmPendingBreakpoint 物件。 這個方法只能由建立 物件的元件呼叫。 (繼承來源 DkmPendingBreakpoint) |
Create(DkmProcess, Guid, DkmCompilerId, DkmThread, Boolean, String, Int32, DkmDataItem) |
建立新的擱置斷點物件。 建立之後,傳回的物件仍會停用,而且不會由斷點管理員追蹤。 若要完成初始化,呼叫端應該在斷點上設定其他屬性,並設定 「啟用」或「註冊」屬性。 呼叫端負責在完成之後關閉已建立的物件。 |
Disable(DkmWorkList, DkmCompletionRoutine<DkmDisablePendingBreakpointAsyncResult>) |
停用擱置的斷點物件,使其不再引發。 如果暫止斷點已經系結,則會隱含停用任何系結斷點。 這個方法會將新的工作專案附加至指定的工作清單,並在附加工作項目之後傳回 。 工作項目的實際處理是異步的。 呼叫端將會透過完成例程收到要求完成的通知。 位置條件約束:必須從 IDE 元件呼叫 API, (元件層級 > 100,000) 。 (繼承來源 DkmPendingBreakpoint) |
Enable(DkmWorkList, DkmCompletionRoutine<DkmEnablePendingBreakpointAsyncResult>) |
設定擱置斷點的狀態,讓未來系結之斷點的實例將會被叫用。 如果尚未註冊擱置的斷點,這個方法也會註冊斷點。 註冊擱置的斷點包含嘗試針對目前載入的任何模組解析斷點,並將斷點新增至斷點管理員在任何模組負載上系結的斷點清單。 如果已註冊擱置斷點,則不會自動啟用現有的綁定斷點。 系結斷點必須個別啟用。 這個方法會將新的工作專案附加至指定的工作清單,並在附加工作項目之後傳回 。 工作項目的實際處理是異步的。 呼叫端將會透過完成例程收到要求完成的通知。 位置條件約束:必須從 IDE 元件呼叫 API, (元件層級 > 100,000) 。 (繼承來源 DkmPendingBreakpoint) |
Enroll(DkmWorkList, DkmCompletionRoutine<DkmEnrollPendingBreakpointAsyncResult>) |
這個方法會註冊擱置的斷點,而不啟用它。 結果是斷點管理員嘗試解析的斷點,但不會引發。 註冊擱置的斷點包含嘗試針對目前載入的任何模組解析斷點,並將斷點新增至斷點管理員在任何模組負載上系結的斷點清單。 這個方法會將新的工作專案附加至指定的工作清單,並在附加工作項目之後傳回 。 工作項目的實際處理是異步的。 呼叫端將會透過完成例程收到要求完成的通知。 位置條件約束:必須從 IDE 元件呼叫 API, (元件層級 > 100,000) 。 (繼承來源 DkmPendingBreakpoint) |
GetBoundBreakpoints() |
GetBoundBreakpoints 會列舉這個 DkmPendingBreakpoint 物件的 DkmBoundBreakpoint 元素。 (繼承來源 DkmPendingBreakpoint) |
GetDataItem<T>() |
取得已新增至這個容器實例的 『T』 實例。 如果此容器不包含 『T』,此函式會傳回 null。 (繼承來源 DkmDataContainer) |
OnBreakpointBound(DkmBoundBreakpoint[]) |
當斷點已系結時,來自斷點管理員的通知。 在使用者設定斷點的情況下,此通知會傳送至 AD7 AL,而 AD7 AL 會引發 IDebugBreakpointBoundEvent2 至 Visual Studio 調試程式 UI。 (繼承來源 DkmPendingBreakpoint) |
OnBreakpointMessage(DkmBreakpointMessageLevel, DkmBreakpointSuggestedFix, Byte, String) |
關於系結斷點狀態的斷點管理員通知。 此 API 是在 Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6) 引進。 (繼承來源 DkmPendingBreakpoint) |
OnBreakpointMessage(DkmBreakpointMessageLevel, DkmBreakpointSuggestedFix, String) |
關於系結斷點狀態的斷點管理員通知。 此 API 是在 Visual Studio 17 Update 4 (DkmApiVersion.VS17Update4) 中引進。 (繼承來源 DkmPendingBreakpoint) |
OnBreakpointMessage(DkmBreakpointMessageLevel, String) |
關於系結斷點狀態的斷點管理員通知。 (繼承來源 DkmPendingBreakpoint) |
OnBreakpointUnbound(DkmBoundBreakpoint[], DkmBreakpointUnboundReason) |
來自斷點管理員的通知,指出指定的斷點未系結。 (繼承來源 DkmPendingBreakpoint) |
OnHitWithError(DkmThread, Boolean, DkmBreakpointMessageLevel, String) |
引發 BreakpointHitWithError 事件。 實作事件接收介面的元件將會收到事件通知。 這個方法會加入事件佇列,而且控件會立即返回呼叫端。 此 API 是在 Visual Studio 16 RTM (DkmApiVersion.VS16RTM) 中引進。 (繼承來源 DkmPendingBreakpoint) |
RemoveDataItem<T>() |
從這個容器中移除 『T』 的實例。 通常不需要呼叫這個方法,因為數據容器會在物件關閉時自動清空。 (繼承來源 DkmDataContainer) |
SetCondition(DkmWorkList, DkmBreakpointCondition, DkmCompletionRoutine<DkmSetPendingBreakpointConditionAsyncResult>) |
初始化、更新或清除此條件斷點之所有系結斷點上的語言層級條件。 如果相同的斷點同時有語言層級條件和叫用計數條件,則會先套用語言層級條件。 這個方法會將新的工作專案附加至指定的工作清單,並在附加工作項目之後傳回 。 工作項目的實際處理是異步的。 呼叫端將會透過完成例程收到要求完成的通知。 位置條件約束:必須從 IDE 元件呼叫 API, (元件層級 > 100,000) 。 (繼承來源 DkmPendingBreakpoint) |
SetDataItem<T>(DkmDataCreationDisposition, T) |
將新專案放在數據容器中。 (繼承來源 DkmDataContainer) |
SetHitCountCondition(DkmWorkList, DkmBreakpointHitCountCondition, DkmCompletionRoutine<DkmSetPendingBreakpointHitCountConditionAsyncResult>) |
初始化、更新或清除這個擱置斷點之所有系結斷點的叫用計數條件。 如果相同的斷點同時有語言層級條件和叫用計數條件,則會先套用語言層級條件。 請注意,叫用計數條件會在每個系結斷點上獨立運作,而不是在擱置斷點上匯總在一起。 例如,如果點擊計數設定為在點擊時停止 #2,而斷點則為兩個不同的位置,其中每一個都叫用斷點一次,UI 仍然不會進入中斷模式,因為兩個個別系結斷點都未達到兩次。 這個方法會將新的工作專案附加至指定的工作清單,並在附加工作項目之後傳回 。 工作項目的實際處理是異步的。 呼叫端將會透過完成例程收到要求完成的通知。 位置條件約束:必須從 IDE 元件呼叫 API, (元件層級 > 100,000) 。 (繼承來源 DkmPendingBreakpoint) |
明確介面實作
IDisposable.Dispose() |
系結至數據表達式而非程式代碼表達式的擱置斷點。 寫入指定的專案時,會引發數據斷點。 (繼承來源 DkmPendingBreakpoint) |