Partilhar via


InvalidCastException Construtores

Definição

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 -> InvalidCastException
Public 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 -> InvalidCastException
Protected 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 -> InvalidCastException
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.

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 -> InvalidCastException
Public 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.

Aplica-se a