InvalidCastException Construtores

Definição

Espaço de Nomes:

System

Assemblagens:

netstandard.dll, System.Runtime.dll

Inicializa uma nova instância da InvalidCastException classe.

Sobrecargas

Name	Description
InvalidCastException()	Inicializa uma nova instância da InvalidCastException classe.
InvalidCastException(String)	Inicializa uma nova instância da InvalidCastException classe com uma mensagem de erro especificada.
InvalidCastException(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da InvalidCastException classe com dados serializados.
InvalidCastException(String, Exception)	Inicializa uma nova instância da InvalidCastException classe com uma mensagem de erro especificada e uma referência à exceção interna que é a causa dessa exceção.
InvalidCastException(String, Int32)	Inicializa uma nova instância da InvalidCastException classe com uma mensagem e código de erro especificados.

InvalidCastException()

Origem:

InvalidCastException.cs

Inicializa uma nova instância da InvalidCastException classe.

public:
 InvalidCastException();

public InvalidCastException();

Public Sub New ()

Observações

Este construtor inicializa a Message propriedade da nova instância numa mensagem fornecida pelo sistema que descreve o erro, como "Não é possível castar do tipo de origem para o tipo de destino." Esta mensagem tem em conta a cultura atual do sistema.

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de InvalidCastException.

Property	Value
InnerException	Uma referência nula (Nothing em Visual Basic).
Message	A cadeia de mensagens de erro localizadas.

InvalidCastException(String)

Origem:

InvalidCastException.cs

Inicializa uma nova instância da InvalidCastException classe com uma mensagem de erro especificada.

public:
 InvalidCastException(System::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.

Observações

Este construtor inicializa a Exception.Message propriedade da nova exceção usando o message parâmetro. O conteúdo de message destina-se a ser compreendido pelos humanos. O chamador deste construtor é obrigado a garantir que esta cadeia foi localizada para a cultura do sistema atual.

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de InvalidCastException.

Property	Value
InnerException	Uma referência nula (Nothing em Visual Basic).
Message	A cadeia de mensagens de erro.

InvalidCastException(SerializationInfo, StreamingContext)

Origem:

InvalidCastException.cs

Atenção

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Inicializa uma nova instância da InvalidCastException classe com dados serializados.

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);

[<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 contém os dados do objeto serializado.

context

StreamingContext

A informação contextual sobre a origem ou destino.

Atributos

ObsoleteAttribute

Observações

Este construtor é chamado durante a desserialização para reconstituir o objeto exceção transmitido através de um fluxo. Para mais informações, consulte XML e Serialização SOAP.

Ver também

• Serialização XML e SOAP

InvalidCastException(String, Exception)

Origem:

InvalidCastException.cs

Inicializa uma nova instância da InvalidCastException classe com uma mensagem de erro especificada e uma referência à exceção interna que é a causa dessa exceção.

public:
 InvalidCastException(System::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. Se o innerException parâmetro não nullfor , a exceção atual é elevada num catch bloco que gere a exceção interna.

Observações

Uma exceção lançada como resultado direto de uma exceção anterior deve incluir uma referência à exceção anterior na InnerException propriedade. A InnerException propriedade devolve o mesmo valor que é passado para o construtor, ou devolve null se a InnerException propriedade não fornecer o valor de exceção interna ao construtor.

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de InvalidCastException.

Property	Value
InnerException	A referência à exceção interna.
Message	A cadeia de mensagens de erro.

Ver também

• Exception
• Exceções de Manuseamento e Lançamento

InvalidCastException(String, Int32)

Origem:

InvalidCastException.cs

Inicializa uma nova instância da InvalidCastException classe com uma mensagem e código de erro especificados.

public:
 InvalidCastException(System::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 a razão pela qual a exceção ocorreu.

errorCode

Int32

O valor do código de erro (HRESULT) associado à exceção.

Observações

Este construtor inicializa a Exception.Message propriedade da nova exceção usando o message parâmetro. O conteúdo de message destina-se a ser compreendido pelos humanos. O chamador deste construtor é obrigado a garantir que esta cadeia foi localizada para a cultura do sistema atual.

Este construtor fornece um valor HRESULT acessível aos herdeiros da InvalidCastException classe, através da propriedade protegida HResult da Exception classe.

A tabela seguinte mostra os valores iniciais das propriedades para uma instância de InvalidCastException.

Property	Value
InnerException	Uma referência nula (Nothing em Visual Basic).
Message	A cadeia de mensagens de erro.