InvalidCastException Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe InvalidCastException.
Sobrecargas
| InvalidCastException() |
Inicializa uma nova instância da classe InvalidCastException. |
| InvalidCastException(String) |
Inicializa uma nova instância da classe InvalidCastException com uma mensagem de erro especificada. |
| InvalidCastException(SerializationInfo, StreamingContext) |
Obsoleto.
Inicializa uma nova instância da classe InvalidCastException com dados serializados. |
| InvalidCastException(String, Exception) |
Inicializa uma nova instância da classe InvalidCastException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção. |
| InvalidCastException(String, Int32) |
Inicializa uma nova instância da classe InvalidCastException com uma mensagem e um código de erro especificados. |
InvalidCastException()
- Origem:
- InvalidCastException.cs
- Origem:
- InvalidCastException.cs
- Origem:
- InvalidCastException.cs
Inicializa uma nova instância da classe InvalidCastException.
public:
InvalidCastException();public InvalidCastException ();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 "Não é possível converter do tipo de origem para o tipo de destino". Essa mensagem leva em conta a cultura atual do sistema.
A tabela a seguir mostra os valores de propriedade inicial de uma instância de InvalidCastException.
| Propriedade | Valor |
|---|---|
| InnerException | Uma referência nula (Nothing no Visual Basic). |
| Message | A cadeia de caracteres da mensagem de erro localizada. |
Aplica-se a
InvalidCastException(String)
- Origem:
- InvalidCastException.cs
- Origem:
- InvalidCastException.cs
- Origem:
- InvalidCastException.cs
Inicializa uma nova instância da classe InvalidCastException com uma mensagem de erro especificada.
public:
InvalidCastException(System::String ^ message);public InvalidCastException (string message);public InvalidCastException (string? message);new InvalidCastException : string -> InvalidCastExceptionPublic Sub New (message As String)Parâmetros
- message
- String
A mensagem que descreve o erro.
Comentários
Este construtor inicializa a propriedade Exception.Message da nova exceção usando-se o parâmetro message. O conteúdo de message deve ser compreendido por humanos. O chamador deste construtor é obrigatório para garantir que esta cadeia de caracteres foi localizada para a cultura do sistema atual.
A tabela a seguir mostra os valores de propriedade inicial de uma instância de InvalidCastException.
| Propriedade | Valor |
|---|---|
| InnerException | Uma referência nula (Nothing no Visual Basic). |
| Message | A cadeia de caracteres da mensagem de erro. |
Aplica-se a
InvalidCastException(SerializationInfo, StreamingContext)
- Origem:
- InvalidCastException.cs
- Origem:
- InvalidCastException.cs
- Origem:
- InvalidCastException.cs
Cuidado
This API supports obsolete formatter-based serialization. It should not be called or extended by application code.
Inicializa uma nova instância da classe InvalidCastException com dados serializados.
protected:
InvalidCastException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);protected InvalidCastException (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 InvalidCastException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);new InvalidCastException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> InvalidCastException[<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 InvalidCastException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> InvalidCastExceptionProtected Sub New (info As SerializationInfo, context As StreamingContext)Parâmetros
- info
- SerializationInfo
O objeto que mantém os dados de objeto serializados.
- context
- StreamingContext
As informações contextuais sobre a origem ou o destino.
- Atributos
Comentários
O construtor é chamado durante a desserialização para reconstituir o objeto de exceção transmitido em um fluxo. Para obter mais informações, consulte serialização XML e SOAP.
Confira também
Aplica-se a
InvalidCastException(String, Exception)
- Origem:
- InvalidCastException.cs
- Origem:
- InvalidCastException.cs
- Origem:
- InvalidCastException.cs
Inicializa uma nova instância da classe InvalidCastException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.
public:
InvalidCastException(System::String ^ message, Exception ^ innerException);public InvalidCastException (string message, Exception innerException);public InvalidCastException (string? message, Exception? innerException);new InvalidCastException : string * Exception -> InvalidCastExceptionPublic Sub New (message As String, innerException As Exception)Parâmetros
- message
- String
A mensagem de erro que explica a razão da exceção.
- innerException
- Exception
A exceção que é a causa da exceção atual. Caso o parâmetro innerException não seja null, a exceção atual é acionada em um bloco catch que identifica a exceção interna.
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. A InnerException propriedade retorna o mesmo valor que é passado para o construtor ou retorna null se a InnerException propriedade não fornece o valor de exceção interna para o construtor.
A tabela a seguir mostra os valores de propriedade inicial de uma instância de InvalidCastException.
| Propriedade | Valor |
|---|---|
| InnerException | A referência de exceção interna. |
| Message | A cadeia de caracteres da mensagem de erro. |
Confira também
Aplica-se a
InvalidCastException(String, Int32)
- Origem:
- InvalidCastException.cs
- Origem:
- InvalidCastException.cs
- Origem:
- InvalidCastException.cs
Inicializa uma nova instância da classe InvalidCastException com uma mensagem e um código de erro especificados.
public:
InvalidCastException(System::String ^ message, int errorCode);public InvalidCastException (string message, int errorCode);public InvalidCastException (string? message, int errorCode);new InvalidCastException : string * int -> InvalidCastExceptionPublic Sub New (message As String, errorCode As Integer)Parâmetros
- message
- String
A mensagem que indica o motivo pelo qual a exceção ocorreu.
- errorCode
- Int32
O valor do código de erro (HRESULT) associado à exceção.
Comentários
Este construtor inicializa a propriedade Exception.Message da nova exceção usando-se o parâmetro message. O conteúdo de message deve ser compreendido por humanos. O chamador deste construtor é obrigatório para garantir que esta cadeia de caracteres foi localizada para a cultura do sistema atual.
Esse construtor fornece um valor HRESULT acessível aos herdadores da InvalidCastException classe , por meio da propriedade protegida HResult da Exception classe .
A tabela a seguir mostra os valores de propriedade inicial de uma instância de InvalidCastException.
| Propriedade | Valor |
|---|---|
| InnerException | Uma referência nula (Nothing no Visual Basic). |
| Message | A cadeia de caracteres da mensagem de erro. |
