FileLoadException 建構函式

定義

命名空間:

System.IO

組件:

System.Runtime.dll

初始化 FileLoadException 類別的新執行個體。

多載

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

FileLoadException()

來源:

FileLoadException.cs

初始化 類別的新實例，並將新實例的 FileLoadException 屬性設定 Message 為系統提供的訊息，以描述錯誤，例如「無法載入指定的檔案」。此訊息會將目前的系統文化特性納入考慮。

public:
 FileLoadException();

public FileLoadException ();

Public Sub New ()

備註

新 InnerException 實體屬性與 FileName 屬性會初始化為 null。

另請參閱

• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

FileLoadException(String)

來源:

FileLoadException.cs

使用指定的錯誤訊息，初始化 FileLoadException 類別的新執行個體。

public:
 FileLoadException(System::String ^ message);

public FileLoadException (string? message);

new System.IO.FileLoadException : string -> System.IO.FileLoadException

Public Sub New (message As String)

參數

message

String

描述錯誤的 String。 message 的內容必須能讓人了解。 需要此建構函式的呼叫者，才能確保此字串已針對目前的系統文化特性進行當地語系化。

備註

這個建構函式會使用 message初始化Message新實例的 屬性。 新 InnerException 實體屬性與 FileName 屬性會初始化為 null。

另請參閱

• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

FileLoadException(SerializationInfo, StreamingContext)

來源:

FileLoadException.cs

警告

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

使用序列化資料，初始化 FileLoadException 類別的新執行個體。

protected:
 FileLoadException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected FileLoadException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.IO.FileLoadException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.IO.FileLoadException

Protected Sub New (info As SerializationInfo, context As StreamingContext)

參數

info

SerializationInfo

SerializationInfo，包含所擲回之例外狀況的相關序列化物件資料。

context

StreamingContext

包含有關來源或目的端內容資訊的 StreamingContext。

屬性

ObsoleteAttribute

另請參閱

• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

FileLoadException(String, Exception)

來源:

FileLoadException.cs

使用指定的錯誤訊息以及造成此例外狀況的內部例外狀況的參考，初始化 FileLoadException 類別的新執行個體。

public:
 FileLoadException(System::String ^ message, Exception ^ inner);

public FileLoadException (string? message, Exception? inner);

new System.IO.FileLoadException : string * Exception -> System.IO.FileLoadException

Public Sub New (message As String, inner As Exception)

參數

message

String

描述錯誤的 String。 message 的內容必須能讓人了解。 需要此建構函式的呼叫者，才能確保此字串已針對目前的系統文化特性進行當地語系化。

inner

Exception

做為目前例外狀況發生原因的例外狀況。 如果 inner 參數不是 null，則目前的例外狀況會在處理內部例外的 catch 區塊中引發。

備註

被擲回以做為前一個例外狀況直接結果的例外狀況，應該在 InnerException 屬性中包含對前一個例外狀況的參考。 InnerException 屬性傳回的值會與傳入建構函式的值相同，或傳回 null (如果 InnerException 屬性未提供內部例外狀況值給建構函式)。

下表顯示 FileLoadException 執行個體的初始屬性值。

屬性	值
InnerException	內部例外狀況參考。
Message	錯誤訊息字串。

如需內部例外狀況的詳細資訊，請參閱 InnerException。

另請參閱

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

FileLoadException(String, String)

來源:

FileLoadException.cs

使用指定的錯誤訊息和無法載入的檔案名稱，初始化 FileLoadException 類別的新執行個體。

public:
 FileLoadException(System::String ^ message, System::String ^ fileName);

public FileLoadException (string? message, string? fileName);

new System.IO.FileLoadException : string * string -> System.IO.FileLoadException

Public Sub New (message As String, fileName As String)

參數

message

String

描述錯誤的 String。 message 的內容必須能讓人了解。 需要此建構函式的呼叫者，才能確保此字串已針對目前的系統文化特性進行當地語系化。

fileName

String

String，包含未載入的檔案名稱。

備註

這個建構函式會使用 初始化新實例的 屬性，並使用 來初始化 MessageFileName 屬性fileName。message InnerException新實體的 屬性會初始化為 null。

FileName 不需要是儲存在磁碟上的檔案;它可以是支援存取數據流之系統的任何部分。 例如，視系統而定，此類別可能能夠存取實體裝置。

另請參閱

• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

FileLoadException(String, String, Exception)

來源:

FileLoadException.cs

使用指定的錯誤訊息、無法載入的檔案名稱和造成這個例外狀況原因的內部例外參考，初始化 FileLoadException 類別的新執行個體。

public:
 FileLoadException(System::String ^ message, System::String ^ fileName, Exception ^ inner);

public FileLoadException (string? message, string? fileName, Exception? inner);

new System.IO.FileLoadException : string * string * Exception -> System.IO.FileLoadException

Public Sub New (message As String, fileName As String, inner As Exception)

參數

message

String

描述錯誤的 String。 message 的內容必須能讓人了解。 需要此建構函式的呼叫者，才能確保此字串已針對目前的系統文化特性進行當地語系化。

fileName

String

String，包含未載入的檔案名稱。

inner

Exception

做為目前例外狀況發生原因的例外狀況。 如果 inner 參數不是 null，則目前的例外狀況會在處理內部例外的 catch 區塊中引發。

備註

被擲回以做為前一個例外狀況直接結果的例外狀況，應該在 InnerException 屬性中包含對前一個例外狀況的參考。 InnerException 屬性傳回的值會與傳入建構函式的值相同，或傳回 null (如果 InnerException 屬性未提供內部例外狀況值給建構函式)。

FileName 不需要是儲存在磁碟上的檔案;它可以是支援存取數據流之系統的任何部分。 例如，視系統而定，此類別可能能夠存取實體裝置。

下表顯示 FileLoadException 執行個體的初始屬性值。

屬性	值
InnerException	內部例外狀況參考。
Message	錯誤訊息字串。

如需內部例外狀況的詳細資訊，請參閱 InnerException。

另請參閱

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