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
| Nome | Description |
|---|---|
| InvalidCastException() |
Inicializa uma nova instância da classe InvalidCastException. |
| 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 classe InvalidCastException com uma mensagem e um 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 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 iniciais de uma instância de InvalidCastException.
| Propriedade | Valor |
|---|---|
| InnerException | Uma referência nula (Nothing no Visual Basic). |
| Message | A cadeia de caracteres de mensagem de erro localizada. |
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 -> InvalidCastExceptionPublic Sub New (message As String)Parâmetros
- message
- String
A mensagem que descreve o erro.
Comentários
Esse construtor inicializa a Exception.Message propriedade da nova exceção usando o message parâmetro. O conteúdo é message destinado a ser compreendido pelos humanos. O chamador desse construtor é necessário para garantir que essa cadeia de caracteres tenha sido localizada para a cultura atual do sistema.
A tabela a seguir mostra os valores de propriedade iniciais de uma instância de InvalidCastException.
| Propriedade | Valor |
|---|---|
| InnerException | Uma referência nula (Nothing no Visual Basic). |
| Message | A cadeia de caracteres de mensagem de erro. |
Aplica-se a
InvalidCastException(SerializationInfo, StreamingContext)
- Origem:
- InvalidCastException.cs
- Origem:
- InvalidCastException.cs
- 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 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 -> InvalidCastExceptionnew 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 contém os dados do objeto serializado.
- context
- StreamingContext
As informações contextuais sobre a origem ou o destino.
- Atributos
Comentários
Esse construtor é chamado durante a desserialização para reconstituir o objeto de exceção transmitido por um fluxo. Para obter mais informações, consulte de serialização XML e SOAP.
Confira também
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 -> InvalidCastExceptionPublic Sub New (message As String, innerException As Exception)Parâmetros
- message
- String
A mensagem de erro que explica o motivo 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 será gerada em um catch bloco que manipula a exceção interna.
Comentários
Uma exceção gerada como resultado direto de uma exceção anterior deve incluir uma referência à exceção anterior na InnerException propriedade. 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 iniciais de uma instância de InvalidCastException.
| Propriedade | Valor |
|---|---|
| InnerException | A referência de exceção interna. |
| Message | A cadeia de caracteres de mensagem de erro. |
Confira 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 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 da exceção ter ocorrido.
- errorCode
- Int32
O valor hresult (código de erro) associado à exceção.
Comentários
Esse construtor inicializa a Exception.Message propriedade da nova exceção usando o message parâmetro. O conteúdo é message destinado a ser compreendido pelos humanos. O chamador desse construtor é necessário para garantir que essa cadeia de caracteres tenha sido localizada para a cultura atual do sistema.
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 iniciais de uma instância de InvalidCastException.
| Propriedade | Valor |
|---|---|
| InnerException | Uma referência nula (Nothing no Visual Basic). |
| Message | A cadeia de caracteres de mensagem de erro. |
