DkmExceptionDetails 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
包含例外狀況或內部例外狀況對象的詳細數據。
此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。
public ref class DkmExceptionDetails : Microsoft::VisualStudio::Debugger::DkmDataContainer, IDisposable
[System.Runtime.InteropServices.Guid("38b85e91-94f6-2dcb-12a0-e937f0e9cee9")]
public class DkmExceptionDetails : Microsoft.VisualStudio.Debugger.DkmDataContainer, IDisposable
[<System.Runtime.InteropServices.Guid("38b85e91-94f6-2dcb-12a0-e937f0e9cee9")>]
type DkmExceptionDetails = class
inherit DkmDataContainer
interface IDisposable
Public Class DkmExceptionDetails
Inherits DkmDataContainer
Implements IDisposable
- 繼承
- 繼承
- 屬性
- 實作
屬性
| Exception |
原始例外狀況物件。 這一律適用於原始引發的例外狀況。 如果這個 DkmExceptionDetails 來自 GetInnerException,這個值仍然代表包含的例外狀況。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| ExceptionCategory |
指出例外狀況的類型。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| InspectionSession |
用來追蹤此實例存留期的檢查會話。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| IsUnloaded |
如果已針對這個對象引發 'unloaded' 事件,則傳回 true (範例:DkmThread::Unload 會呼叫) 或物件已關閉。 請注意,檢查此狀態時必須小心,而不進行同步處理,傳回的狀態在讀取之後可能無法再精確指示。 (繼承來源 DkmDataContainer) |
| RuntimeInstance |
DkmRuntimeInstance 類別代表載入至 DkmProcess 的執行環境,其中包含要偵錯的程式代碼。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| UniqueId |
Guid 可唯一識別這個例外狀況詳細數據物件。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
方法
| Close() |
關閉例外狀況詳細數據物件及其相關聯的資源。 當相關聯的 DkmInspectionSession 物件關閉時,會自動關閉 DkmExceptionDetails 物件。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| Create(DkmInspectionSession, DkmExceptionInformation, DkmDataItem) |
Create 新的 DkmExceptionDetails 對象實例。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetCorException() |
取得例外狀況物件的 ICorDebugValue。 位置條件約束:必須從監視器元件 (元件層級 < 100,000) 呼叫 API。 此 API 是在 Visual Studio 15 Update 7 (DkmApiVersion.VS15Update7) 中引進。 |
| GetDataItem<T>() |
取得已新增至這個容器實例的 『T』 實例。 如果此容器不包含 『T』,此函式會傳回 null。 (繼承來源 DkmDataContainer) |
| GetExceptionMessage() |
取得與例外狀況關聯的訊息。 訊息的格式不正確。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetExceptionObjectExpression() |
取得表示例外狀況對象的表達式。 如果沒有這類物件可用,這個方法會傳回 null。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetFormattedDescription() |
取得這個訊息的描述,可格式化為包含粗體/斜體文字。 文字可以透過包裝在 「**」 區塊中,或在 「*」 區塊中換行來建立斜體。 例如「粗體文字:非粗體文字 - 斜體」。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetHResult() |
取得這個例外狀況的 HResult 程式代碼。 如果沒有可用的堆疊追蹤,這個方法會傳回 null。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetInnerException() |
如果可用,取得內部例外狀況。 如果沒有內部例外狀況,這個方法會傳回 null。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetRethrownCallStack(Boolean, DkmVariableInfoFlags, DkmCallStackFilterOptions, DkmInstructionAddress[]) |
取得擲回例外狀況的文字,類似於 .NET 例外狀況的 StackTrace 屬性。 Visual Studio 例外狀況 UI 會使用此 API。 這會在實作不想要顯示呼叫堆疊的案例中傳回空字串,例如,如果所有框架都已經存在於呼叫堆棧視窗中。 此 API 是在 Visual Studio 16 Update 4 (DkmApiVersion.VS16Update4) 引進。 |
| GetSource() |
取得這個例外狀況的來源。 如果沒有可用的來源,這個方法會傳回 null。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetStackTrace() |
取得這個例外狀況的堆疊追蹤。 如果沒有可用的堆疊追蹤,這個方法會傳回 null。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetStackTraceInstructionAddresses() |
取得擲回這個例外狀況之原始呼叫堆疊的指令位址。 此 API 是在 Visual Studio 16 Update 4 (DkmApiVersion.VS16Update4) 引進。 |
| GetTypeName(Boolean) |
取得例外狀況的類型名稱。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| RemoveDataItem<T>() |
從這個容器中移除 『T』 的實例。 通常不需要呼叫這個方法,因為數據容器會在物件關閉時自動清空。 (繼承來源 DkmDataContainer) |
| SetDataItem<T>(DkmDataCreationDisposition, T) |
將新專案放在數據容器中。 (繼承來源 DkmDataContainer) |
明確介面實作
| IDisposable.Dispose() |
即將加入。 |