InvalidCastException Construtores

Definição

Espaço de Nomes:: System

Assemblagens:: mscorlib.dll, System.Runtime.dll

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

Origem:: InvalidCastException.cs

Origem:: InvalidCastException.cs

Origem:: InvalidCastException.cs

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.

Aplica-se a

InvalidCastException(String)

Origem:: InvalidCastException.cs

Origem:: InvalidCastException.cs

Origem:: InvalidCastException.cs

Origem:: InvalidCastException.cs

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

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.

Aplica-se a

InvalidCastException(SerializationInfo, StreamingContext)

Origem:: InvalidCastException.cs

Origem:: InvalidCastException.cs

Origem:: InvalidCastException.cs

Origem:: InvalidCastException.cs

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

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

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

Aplica-se a

InvalidCastException(String, Exception)

Origem:: InvalidCastException.cs

Origem:: InvalidCastException.cs

Origem:: InvalidCastException.cs

Origem:: InvalidCastException.cs

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

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

Aplica-se a

InvalidCastException(String, Int32)

Origem:: InvalidCastException.cs

Origem:: InvalidCastException.cs

Origem:: InvalidCastException.cs

Origem:: InvalidCastException.cs

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

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

Aplica-se a

Comentários

Esta página foi útil?