FormatException Construtores
Definição
Inicializa uma nova instância da classe FormatException.Initializes a new instance of the FormatException class.
Sobrecargas
| FormatException() |
Inicializa uma nova instância da classe FormatException.Initializes a new instance of the FormatException class. |
| FormatException(String) |
Inicializa uma nova instância da classe FormatException com uma mensagem de erro especificada.Initializes a new instance of the FormatException class with a specified error message. |
| FormatException(SerializationInfo, StreamingContext) |
Inicializa uma nova instância da classe FormatException com dados serializados.Initializes a new instance of the FormatException class with serialized data. |
| FormatException(String, Exception) |
Inicializa uma nova instância da classe FormatException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.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()
Inicializa uma nova instância da classe FormatException.Initializes a new instance of the FormatException class.
public:
FormatException();
public FormatException ();
Public Sub New ()
Comentários
Esse construtor inicializa a Message propriedade da nova instância para uma mensagem fornecida pelo sistema que descreve o erro, como "formato inválido".This constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "Invalid format." Essa mensagem considera a cultura do sistema atual.This message takes into account the current system culture.
A tabela a seguir mostra os valores de propriedade inicial de uma instância de FormatException.The following table shows the initial property values for an instance of FormatException.
| PropriedadeProperty | ValorValue |
|---|---|
| InnerException | Uma referência nula (Nothing no Visual Basic).A null reference (Nothing in Visual Basic). |
| Message | A cadeia de caracteres da mensagem de erro localizada.The localized error message string. |
Aplica-se a
FormatException(String)
Inicializa uma nova instância da classe FormatException com uma mensagem de erro especificada.Initializes a new instance of the FormatException class with a specified error message.
public:
FormatException(System::String ^ message);
public FormatException (string message);
public FormatException (string? message);
new FormatException : string -> FormatException
Public Sub New (message As String)
Parâmetros
- message
- String
A mensagem que descreve o erro.The message that describes the error.
Comentários
Este construtor inicializa a propriedade Exception.Message da nova exceção usando-se o parâmetro message.This constructor initializes the Exception.Message property of the new exception using the message parameter. O conteúdo de message deve ser compreendido por humanos.The content of message is intended to be understood by humans. O chamador deste construtor é obrigatório para garantir que esta cadeia de caracteres foi localizada para a cultura do sistema atual.The caller of this constructor is required to ensure that this string has been localized for the current system culture.
A tabela a seguir mostra os valores de propriedade inicial de uma instância de FormatException.The following table shows the initial property values for an instance of FormatException.
| PropriedadeProperty | ValorValue |
|---|---|
| InnerException | Uma referência nula (Nothing no Visual Basic).A null reference (Nothing in Visual Basic). |
| Message | A cadeia de caracteres da mensagem de erro.The error message string. |
Aplica-se a
FormatException(SerializationInfo, StreamingContext)
Inicializa uma nova instância da classe FormatException com dados serializados.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)
Parâmetros
- info
- SerializationInfo
O objeto que mantém os dados de objeto serializados.The object that holds the serialized object data.
- context
- StreamingContext
As informações contextuais sobre a origem ou o destino.The contextual information about the source or destination.
Comentários
O construtor é chamado durante a desserialização para reconstituir o objeto de exceção transmitido em um fluxo.This constructor is called during deserialization to reconstitute the exception object transmitted over a stream.
Aplica-se a
FormatException(String, Exception)
Inicializa uma nova instância da classe FormatException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.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);
public FormatException (string? message, Exception? innerException);
new FormatException : string * Exception -> FormatException
Public Sub New (message As String, innerException As Exception)
Parâmetros
- message
- String
A mensagem de erro que explica a razão da exceção.The error message that explains the reason for the exception.
- innerException
- Exception
A exceção que é a causa da exceção atual.The exception that is the cause of the current exception. Caso o parâmetro innerException não seja uma referência nula (Nothing no Visual Basic), a atual exceção é acionada em um bloco catch que identifica a exceção interna.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.
Comentários
Uma exceção que é lançada como um resultado direto de uma exceção anterior deve incluir uma referência para a exceção anterior na propriedade 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. A propriedade InnerException retorna o mesmo valor que é passado para o construtor ou uma referência nula (Nothing no Visual Basic) caso a propriedade InnerException não forneça o valor de exceção interna para o construtor.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.
A tabela a seguir mostra os valores de propriedade inicial de uma instância de FormatException.The following table shows the initial property values for an instance of FormatException.
| PropriedadeProperty | ValorValue |
|---|---|
| InnerException | A referência de exceção interna.The inner exception reference. |
| Message | A cadeia de caracteres da mensagem de erro.The error message string. |