FileLoadException 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
例外是當找到管理組件但無法載入時拋出的例外。
public ref class FileLoadException : System::IO::IOException
public class FileLoadException : System.IO.IOException
[System.Serializable]
public class FileLoadException : System.IO.IOException
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class FileLoadException : System.IO.IOException
type FileLoadException = class
inherit IOException
[<System.Serializable>]
type FileLoadException = class
inherit IOException
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileLoadException = class
inherit IOException
Public Class FileLoadException
Inherits IOException
- 繼承
- 繼承
- 屬性
備註
代表當 Assembly 檔案已找到但無法載入時所發生的錯誤。
FileNotFoundException當檔案無法載入,因為無法找到該檔案時,會拋出這個例外。 若檔案已定位,但因權限不足無法載入,則拋出 a SecurityException 。
FileLoadException 預設 HRESULT 為 COR_E_FILELOAD,其值為 0x80131621,但這並非唯一可能的 HRESULT。
靜態組件參考載入的確切時間尚未明確說明。 此例外可在靜態參考未能載入的組件方法開始執行前拋出。
Note
此例外未包含在 Windows 商店的 .NET 應用程式 或 可攜式類別函式庫中,但部分成員會拋出。 在這種情況下要捕捉例外,請寫一個 catch 代為 IOException 的陳述。
相關建議
確保檔案是有效的 .NET 組合語言。 若檔案不是有效的 .NET 組合語言,則會拋出此例外。 如需詳細資訊,請參閱Assembly。
檢查是否有組件或模組被載入兩次,且有兩個不同的證據。 證據是構成安全政策決策輸入的資訊集合,例如程式碼可獲得哪些權限。 欲了解更多資訊,請參閱 GacRemove 及 Evidence
若使用 RegisterAssembly or UnRegisterAssembly 方法,請檢查組件名稱不超過系統定義的最大長度。 組裝名稱的長度不得超過系統定義的最大值。 如需詳細資訊,請參閱PathTooLongException。
如果要載入衛星組件,請確保指定的 CultureInfo 與檔案的 CultureInfo 相符。 衛星組件包含在地化資源,這些資源包含不可在地化的可執行程式碼,以及單一文化作為預設或中立文化的資源。 如需詳細資訊,請參閱GetSatelliteAssembly。
建構函式
| 名稱 | Description |
|---|---|
| FileLoadException() |
初始化該類別的新實例 FileLoadException ,並將新實例的屬性設定 Message 為系統提供的訊息,描述錯誤,例如「無法載入指定檔案」。此訊息考量了當前系統文化。 |
| FileLoadException(SerializationInfo, StreamingContext) |
已淘汰.
初始化一個新的類別實例 FileLoadException ,並使用序列化資料。 |
| FileLoadException(String, Exception) |
初始化類別的新實例 FileLoadException ,並附上指定的錯誤訊息及導致該異常的內部例外的參考。 |
| FileLoadException(String, String, Exception) |
初始化一個新的類別實例 FileLoadException ,並附上指定的錯誤訊息、無法載入的檔案名稱,以及導致該異常的內部例外的參考。 |
| FileLoadException(String, String) |
初始化類別的新實例 FileLoadException ,並以指定的錯誤訊息及無法載入的檔案名稱。 |
| FileLoadException(String) |
初始化該類別的新實例 FileLoadException ,並以指定的錯誤訊息。 |
屬性
| 名稱 | Description |
|---|---|
| Data |
取得一組鍵值對,提供關於例外的額外使用者定義資訊。 (繼承來源 Exception) |
| FileName |
會取得造成此異常的檔案名稱。 |
| FusionLog |
取得描述組裝失敗原因的日誌檔。 |
| HelpLink |
取得或設定與此例外相關的說明檔案連結。 (繼承來源 Exception) |
| HResult |
取得或設定 HRESULT,一個編碼的數值,指派給特定例外。 (繼承來源 Exception) |
| InnerException |
會取得 Exception 造成目前例外的實例。 (繼承來源 Exception) |
| Message |
會收到錯誤訊息以及造成此異常的檔案名稱。 |
| Source |
取得或設定造成錯誤之應用程式或物件的名稱。 (繼承來源 Exception) |
| StackTrace |
會取得呼叫堆疊上即時框架的字串表示。 (繼承來源 Exception) |
| TargetSite |
會取得拋出當前例外的方法。 (繼承來源 Exception) |
方法
| 名稱 | Description |
|---|---|
| Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
| GetBaseException() |
當在派生類別中被覆寫時,回傳 Exception 是一個或多個後續例外的根因。 (繼承來源 Exception) |
| GetHashCode() |
做為預設哈希函式。 (繼承來源 Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
已淘汰.
設定 檔案 SerializationInfo 名稱及額外例外資訊。 |
| GetType() |
取得目前實例的執行時型態。 (繼承來源 Exception) |
| MemberwiseClone() |
建立目前 Object的淺層複本。 (繼承來源 Object) |
| ToString() |
回傳目前例外的完整限定名稱,可能還會回傳錯誤訊息、內部例外名稱及堆疊追蹤。 |
事件
| 名稱 | Description |
|---|---|
| SerializeObjectState |
已淘汰.
當例外被序列化以建立包含該例外序列化資料的例外狀態物件時,會發生這種情況。 (繼承來源 Exception) |