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 Пустая ссылка (Nothing в Visual Basic).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.

Комментарии

Этот конструктор инициализирует Exception.Message свойство нового исключения 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 Пустая ссылка (Nothing в Visual Basic).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 (Nothing в Visual Basic), то текущее исключение создается в блоке 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.

Дополнительно

Применяется к