ConfigurationException 類別

定義

發生組態系統錯誤時所擲回的例外狀況。The exception that is thrown when a configuration system error has occurred.

public ref class ConfigurationException : SystemException
[System.Serializable]
public class ConfigurationException : SystemException
type ConfigurationException = class
    inherit SystemException
Public Class ConfigurationException
Inherits SystemException
繼承
ConfigurationException
衍生
屬性

備註

如果應用程式嘗試讀取或寫入資料至設定檔,但不成功,則會擲回 ConfigurationException 例外狀況。The ConfigurationException exception is thrown if the application attempts to read or write data to the configuration file but is unsuccessful. 一些可能的原因可能是設定檔案中的 XML 格式不正確、檔案許可權問題,以及設定屬性的值無效。Some possible reasons for this can include malformed XML in the configuration file, file permission issues, and configuration properties with values that are not valid.

注意

為了回溯相容性,會維護 ConfigurationException 物件。The ConfigurationException object is maintained for backward compatibility. ConfigurationErrorsException 物件會將它取代為設定系統。The ConfigurationErrorsException object replaces it for the configuration system.

建構函式

ConfigurationException()

初始化 ConfigurationException 類別的新執行個體。Initializes a new instance of the ConfigurationException class.

ConfigurationException(SerializationInfo, StreamingContext)

初始化 ConfigurationException 類別的新執行個體。Initializes a new instance of the ConfigurationException class.

ConfigurationException(String)

初始化 ConfigurationException 類別的新執行個體。Initializes a new instance of the ConfigurationException class.

ConfigurationException(String, Exception)

初始化 ConfigurationException 類別的新執行個體。Initializes a new instance of the ConfigurationException class.

ConfigurationException(String, Exception, String, Int32)

初始化 ConfigurationException 類別的新執行個體。Initializes a new instance of the ConfigurationException class.

ConfigurationException(String, Exception, XmlNode)

初始化 ConfigurationException 類別的新執行個體。Initializes a new instance of the ConfigurationException class.

ConfigurationException(String, String, Int32)

初始化 ConfigurationException 類別的新執行個體。Initializes a new instance of the ConfigurationException class.

ConfigurationException(String, XmlNode)

初始化 ConfigurationException 類別的新執行個體。Initializes a new instance of the ConfigurationException class.

屬性

BareMessage

取得擲回此組態例外狀況原因的描述。Gets a description of why this configuration exception was thrown.

Data

取得提供例外狀況之其他使用者定義相關資訊的索引鍵/值組集合。Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(繼承來源 Exception)
Filename

取得導致此組態例外狀況擲回的組態檔之路徑。Gets the path to the configuration file that caused this configuration exception to be thrown.

HelpLink

取得或設定與這個例外狀況相關聯的說明檔連結。Gets or sets a link to the help file associated with this exception.

(繼承來源 Exception)
HResult

取得或設定 HRESULT,它是指派給特定例外狀況的編碼數值。Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(繼承來源 Exception)
InnerException

取得造成目前例外狀況的 Exception 執行個體。Gets the Exception instance that caused the current exception.

(繼承來源 Exception)
Line

取得組態檔中擲回此組態例外狀況的行號。Gets the line number within the configuration file at which this configuration exception was thrown.

Message

取得擲回此組態例外狀況原因的擴充描述。Gets an extended description of why this configuration exception was thrown.

Source

取得或設定造成錯誤的應用程式或物件的名稱。Gets or sets the name of the application or the object that causes the error.

(繼承來源 Exception)
StackTrace

取得呼叫堆疊上即時運算框架的字串表示。Gets a string representation of the immediate frames on the call stack.

(繼承來源 Exception)
TargetSite

取得擲回目前例外狀況的方法。Gets the method that throws the current exception.

(繼承來源 Exception)

方法

Equals(Object)

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

(繼承來源 Object)
GetBaseException()

在衍生類別中覆寫時,傳回一或多個後續的例外狀況的根本原因 ExceptionWhen overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(繼承來源 Exception)
GetHashCode()

做為預設雜湊函式。Serves as the default hash function.

(繼承來源 Object)
GetObjectData(SerializationInfo, StreamingContext)

以發生這個組態例外狀況的檔案名稱和行號,設定 SerializationInfo 物件。Sets the SerializationInfo object with the file name and line number at which this configuration exception occurred.

GetType()

取得目前執行個體的執行階段類型。Gets the runtime type of the current instance.

(繼承來源 Exception)
GetXmlNodeFilename(XmlNode)

取得當擲回此組態例外狀況時,載入內部 XmlNode 物件的來源組態檔之路徑。Gets the path to the configuration file from which the internal XmlNode object was loaded when this configuration exception was thrown.

GetXmlNodeLineNumber(XmlNode)

取得當擲回此組態例外狀況時,內部 XmlNode 物件在組態檔中表示的行號。Gets the line number within the configuration file that the internal XmlNode object represented when this configuration exception was thrown.

MemberwiseClone()

建立目前 Object 的淺層複製。Creates a shallow copy of the current Object.

(繼承來源 Object)
ToString()

建立並傳回目前例外狀況的字串表示。Creates and returns a string representation of the current exception.

(繼承來源 Exception)

事件

SerializeObjectState

當例外狀況序列化,以建立包含例外狀況相關序列化資料的例外狀況狀態物件時,就會發生此事件。Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(繼承來源 Exception)

適用於

另請參閱