InsufficientMemoryException 類別

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

來源:

InsufficientMemoryException.cs

當檢查可用記憶體足夠失敗時拋出的例外。 無法繼承這個類別。

public ref class InsufficientMemoryException sealed : OutOfMemoryException

public sealed class InsufficientMemoryException : OutOfMemoryException

type InsufficientMemoryException = class
    inherit OutOfMemoryException

Public NotInheritable Class InsufficientMemoryException
Inherits OutOfMemoryException

繼承

Object

Exception

SystemException

OutOfMemoryException

InsufficientMemoryException

備註

與 OutOfMemoryException不同， InsufficientMemoryException 是在開始操作前拋出，因此不代表狀態損壞。 應用程式可以捕捉此異常，降低記憶體使用量，並避免實際記憶體不足的情況及其可能破壞程式狀態的風險。

當你指定一個預測記憶體配置大於目前可用記憶體量時，建構子會拋 MemoryFailPoint 出此例外。 你的程式可以捕捉到異常，然後延遲需要記憶體的任務，或是以較小的步驟執行，這樣所需的記憶體會比較少。

請參考該 MemoryFailPoint 類別的程式碼範例。

建構函式

名稱	Description
InsufficientMemoryException()	初始化該類別的新實例 InsufficientMemoryException ，並以系統提供的訊息描述錯誤。
InsufficientMemoryException(String, Exception)	初始化類別的新實例 InsufficientMemoryException ，並附上指定的錯誤訊息及導致該異常的內部例外的參考。
InsufficientMemoryException(String)	初始化類別的新實例 InsufficientMemoryException ，並以指定訊息描述錯誤。

屬性

名稱	Description
Data	取得索引鍵/值組的集合，提供例外狀況的其他使用者定義資訊。 (繼承來源 Exception)
HelpLink	取得或設定與這個例外狀況相關聯的說明檔連結。 (繼承來源 Exception)
HResult	取得或設定 HRESULT，這是指派給特定例外狀況的編碼數值。 (繼承來源 Exception)
InnerException	會取得 Exception 造成目前例外的實例。 (繼承來源 Exception)
Message	會收到描述目前例外的訊息。 (繼承來源 Exception)
Source	取得或設定造成錯誤之應用程式或物件的名稱。 (繼承來源 Exception)
StackTrace	取得呼叫堆疊上即時框架的字串表示。 (繼承來源 Exception)
TargetSite	取得擲回目前例外狀況的方法。 (繼承來源 Exception)

方法

名稱	Description
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetBaseException()	當在派生類別中被覆寫時，回傳 Exception 是一個或多個後續例外的根因。 (繼承來源 Exception)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetObjectData(SerializationInfo, StreamingContext)	已淘汰. 當在衍生類別中覆寫時，會設定 SerializationInfo 並包含例外的資訊。 (繼承來源 Exception)
GetType()	取得目前實例的運行時間類型。 (繼承來源 Exception)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	建立並回傳當前例外的字串表示。 (繼承來源 Exception)

事件

名稱	Description
SerializeObjectState	已淘汰. 發生於例外狀況串行化以建立例外狀況狀態物件，其中包含例外狀況的串行化數據。 (繼承來源 Exception)

另請參閱

• MemoryFailPoint