FileLoadException 類別

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

FileLoadException.cs

已找到 Managed 組件卻無法載入時所擲回的例外狀況。

public ref class FileLoadException : System::IO::IOException

public class FileLoadException : System.IO.IOException

type FileLoadException = class
    inherit IOException

Public Class FileLoadException
Inherits IOException

繼承

Object

Exception

SystemException

IOException

FileLoadException

備註

表示找到檔案但無法載入時 Assembly 所發生的錯誤。

FileNotFoundException檔案無法載入時，會擲回例外狀況，因為它無法找到。 如果檔案位於，但因為權限不足而無法載入， SecurityException 則會擲回 。

FileLoadException 具有預設 HRESULT COR_E_FILELOAD，其值為 0x80131621，但這不是唯一可能的 HRESULT。

未指定載入靜態元件參考的確切時間。 在靜態參考無法載入的元件開始執行的方法之前，可能會擲回這個例外狀況。

注意

此例外狀況不包含在 適用於 Windows 市集應用程式的 .NET 或 可攜式類別庫中，但會由某些成員擲回。 若要攔截該案例中的例外狀況，請 catch 改為撰寫 的 IOException 語句。

相關秘訣

請確定檔案是有效的 .NET 元件。 如果檔案不是有效的 .NET 元件，就會擲回這個例外狀況。 如需詳細資訊，請參閱Assembly。

檢查以確定未使用兩個不同的辨識項，載入組件或模組兩次。 所謂的辨識項是一組資訊，由輸入的安全性原則決策所構成，例如要將那些權限授與給程式碼。 如需詳細資訊，請參閱 GacRemove和 Evidence。

如果使用 RegisterAssembly 或 UnRegisterAssembly 方法，請檢查以確定元件名稱長度不超過系統定義的最大長度。 元件名稱的長度不能超過系統定義的最大值。 如需詳細資訊，請參閱PathTooLongException。

載入附屬組件時，請確定指定的 CultureInfo 需符合該檔案的 CultureInfo。 附屬組件包含了當地語系化資源，這些資源中含有不能當地語系化的可執行程式碼。附屬組件也包含了單一文化的資源，用以做為預設或中性文化。 如需詳細資訊，請參閱GetSatelliteAssembly。

建構函式

FileLoadException()	初始化 類別的新實例 FileLoadException ，並將新實例的 屬性設定 Message 為描述錯誤的系統提供的訊息，例如「無法載入指定的檔案」。此訊息會將目前的系統文化特性納入考慮。
FileLoadException(SerializationInfo, StreamingContext)	已淘汰. 使用序列化資料，初始化 FileLoadException 類別的新執行個體。
FileLoadException(String)	使用指定的錯誤訊息，初始化 FileLoadException 類別的新執行個體。
FileLoadException(String, Exception)	使用指定的錯誤訊息以及造成此例外狀況的內部例外狀況的參考，初始化 FileLoadException 類別的新執行個體。
FileLoadException(String, String)	使用指定的錯誤訊息和無法載入的檔案名稱，初始化 FileLoadException 類別的新執行個體。
FileLoadException(String, String, Exception)	使用指定的錯誤訊息、無法載入的檔案名稱和造成這個例外狀況原因的內部例外參考，初始化 FileLoadException 類別的新執行個體。

屬性

Data	取得鍵值組的集合，這些鍵值組會提供關於例外狀況的其他使用者定義資訊。 (繼承來源 Exception)
FileName	取得造成這個例外狀況的檔案名稱。
FusionLog	取得描述為什麼組件載入失敗的記錄檔。
HelpLink	取得或設定與這個例外狀況相關聯的說明檔連結。 (繼承來源 Exception)
HResult	取得或設定 HRESULT，它是指派給特定例外狀況的編碼數值。 (繼承來源 Exception)
InnerException	取得造成目前例外狀況的 Exception 執行個體。 (繼承來源 Exception)
Message	取得造成這個例外狀況的錯誤訊息和檔案名稱。
Source	取得或設定造成錯誤的應用程式或物件的名稱。 (繼承來源 Exception)
StackTrace	取得呼叫堆疊上即時運算框架的字串表示。 (繼承來源 Exception)
TargetSite	取得擲回目前例外狀況的方法。 (繼承來源 Exception)

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetBaseException()	在衍生類別中覆寫時，傳回一或多個後續的例外狀況的根本原因 Exception。 (繼承來源 Exception)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetObjectData(SerializationInfo, StreamingContext)	已淘汰. 以檔案名稱和其他例外狀況資訊設定 SerializationInfo。
GetType()	取得目前執行個體的執行階段類型。 (繼承來源 Exception)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回目前例外狀況的完整名稱、可能的錯誤訊息、內部例外的名稱和堆疊追蹤。

事件

SerializeObjectState

已淘汰. 當例外狀況序列化，以建立包含例外狀況相關序列化資料的例外狀況狀態物件時，就會發生此事件。 (繼承來源 Exception)

另請參閱

• Exception
• 在 .NET 中處理和擲回例外狀況
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案