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 DkmPendingBreakpointPublic 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) |