FormatException 构造函数

定义

初始化 FormatException 类的新实例。Initializes a new instance of the FormatException class.

重载

FormatException()

初始化 FormatException 类的新实例。Initializes a new instance of the FormatException class.

FormatException(String)

用指定的错误消息初始化 FormatException 类的新实例。Initializes a new instance of the FormatException class with a specified error message.

FormatException(SerializationInfo, StreamingContext)

使用序列化数据初始化 FormatException 类的新实例。Initializes a new instance of the FormatException class with serialized data.

FormatException(String, Exception)

使用指定的错误消息和对作为此异常原因的内部异常的引用来初始化 FormatException 类的新实例。Initializes a new instance of the FormatException class with a specified error message and a reference to the inner exception that is the cause of this exception.

FormatException()

初始化 FormatException 类的新实例。Initializes a new instance of the FormatException class.

public:
 FormatException();
public FormatException ();
Public Sub New ()

注解

此构造函数将新实例的 Message 属性初始化为系统提供的描述错误的消息,如 "格式无效"。This constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "Invalid format." 此消息会考虑当前系统区域性。This message takes into account the current system culture.

下表显示 FormatException 的实例的初始属性值。The following table shows the initial property values for an instance of FormatException.

属性Property Value
InnerException 空引用(在 Visual Basic 中为 Nothing)。A null reference (Nothing in Visual Basic).
Message 本地化的错误消息字符串。The localized error message string.

FormatException(String)

用指定的错误消息初始化 FormatException 类的新实例。Initializes a new instance of the FormatException class with a specified error message.

public:
 FormatException(System::String ^ message);
public FormatException (string message);
new FormatException : string -> FormatException
Public Sub New (message As String)

参数

message
String

用于描述错误的消息。The message that describes the error.

注解

此构造函数使用 message 参数初始化新异常的 Exception.Message 属性。This constructor initializes the Exception.Message property of the new exception using the message parameter. message 的内容设计为易于理解。The content of message is intended to be understood by humans. 此构造函数的调用方需要确保此字符串已针对当前系统区域性进行了本地化。The caller of this constructor is required to ensure that this string has been localized for the current system culture.

下表显示 FormatException 的实例的初始属性值。The following table shows the initial property values for an instance of FormatException.

属性Property Value
InnerException 空引用(在 Visual Basic 中为 Nothing)。A null reference (Nothing in Visual Basic).
Message 错误消息字符串。The error message string.

FormatException(SerializationInfo, StreamingContext)

使用序列化数据初始化 FormatException 类的新实例。Initializes a new instance of the FormatException class with serialized data.

protected:
 FormatException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected FormatException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new FormatException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> FormatException
Protected Sub New (info As SerializationInfo, context As StreamingContext)

参数

info
SerializationInfo

包含序列化对象数据的对象。The object that holds the serialized object data.

context
StreamingContext

与源或目标有关的上下文信息。The contextual information about the source or destination.

注解

在反序列化期间调用此构造函数以重新构造在流上传输的异常对象。This constructor is called during deserialization to reconstitute the exception object transmitted over a stream.

FormatException(String, Exception)

使用指定的错误消息和对作为此异常原因的内部异常的引用来初始化 FormatException 类的新实例。Initializes a new instance of the FormatException class with a specified error message and a reference to the inner exception that is the cause of this exception.

public:
 FormatException(System::String ^ message, Exception ^ innerException);
public FormatException (string message, Exception innerException);
new FormatException : string * Exception -> FormatException
Public Sub New (message As String, innerException As Exception)

参数

message
String

解释异常原因的错误消息。The error message that explains the reason for the exception.

innerException
Exception

引起当前异常的异常。The exception that is the cause of the current exception. 如果 innerException 参数不是 null 引用(在 Visual Basic 中为 Nothing),则在处理内部异常的 catch 块中引发当前异常。If the innerException parameter is not a null reference (Nothing in Visual Basic), the current exception is raised in a catch block that handles the inner exception.

注解

因前一个异常而直接引发的异常应在 InnerException 属性中包含对前一个异常的引用。An exception that is thrown as a direct result of a previous exception should include a reference to the previous exception in the InnerException property. InnerException 属性返回传递到构造函数中的相同值,或者如果 Nothing 属性不向构造函数提供内部异常值,则为空引用(在 Visual Basic 中为 InnerException)。The InnerException property returns the same value that is passed into the constructor, or a null reference (Nothing in Visual Basic) if the InnerException property does not supply the inner exception value to the constructor.

下表显示 FormatException 的实例的初始属性值。The following table shows the initial property values for an instance of FormatException.

属性Property Value
InnerException 内部异常引用。The inner exception reference.
Message 错误消息字符串。The error message string.

另请参阅

适用于