TypeConverter.IsValid Método
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.
Retorna se o objeto de valor especificado é válido para esse tipo.
Sobrecargas
IsValid(ITypeDescriptorContext, Object) |
Retorna se o objeto de valor fornecido é válido para esse tipo e para o contexto especificado. |
IsValid(Object) |
Retorna se o objeto de valor especificado é válido para esse tipo. |
IsValid(ITypeDescriptorContext, Object)
- Origem:
- TypeConverter.cs
- Origem:
- TypeConverter.cs
- Origem:
- TypeConverter.cs
Retorna se o objeto de valor fornecido é válido para esse tipo e para o contexto especificado.
public:
virtual bool IsValid(System::ComponentModel::ITypeDescriptorContext ^ context, System::Object ^ value);
public virtual bool IsValid (System.ComponentModel.ITypeDescriptorContext context, object value);
public virtual bool IsValid (System.ComponentModel.ITypeDescriptorContext? context, object? value);
abstract member IsValid : System.ComponentModel.ITypeDescriptorContext * obj -> bool
override this.IsValid : System.ComponentModel.ITypeDescriptorContext * obj -> bool
Public Overridable Function IsValid (context As ITypeDescriptorContext, value As Object) As Boolean
Parâmetros
- context
- ITypeDescriptorContext
Um ITypeDescriptorContext que fornece um contexto de formato.
Retornos
true
se o valor especificado for válido para esse objeto; caso contrário, false
.
Exemplos
Para obter um exemplo dessa função, consulte a TypeConverter classe .
Comentários
Use o context
parâmetro para extrair informações adicionais sobre o ambiente do qual esse conversor é invocado. Esse parâmetro pode ser null
, portanto, sempre marcar-lo. Além disso, as propriedades no objeto de contexto podem retornar null
.
Começando no .NET Framework 4, o IsValid método captura exceções dos CanConvertFrom métodos e ConvertFrom . Se o tipo de valor de entrada fizer CanConvertFrom com que retorne false
ou se o valor de entrada causar ConvertFrom a geração de uma exceção, o IsValid método retornará false
.
Para habilitar o comportamento herdado, insira as linhas a seguir no arquivo de configuração do aplicativo .NET Framework.
<configuration>
<appSettings>
<add key="UseCompatibleTypeConverterBehavior" value="true" />
</appSettings>
</configuration>
Notas aos Herdeiros
Substitua esse método se o tipo que você deseja converter der suporte a valores padrão que podem ser validados.
O IsValid(ITypeDescriptorContext, Object) método é usado para validar um valor dentro do tipo em vez de determinar se value
pode ser convertido no tipo fornecido. Por exemplo, IsValid(ITypeDescriptorContext, Object) pode ser usado para determinar se um determinado valor é válido para um tipo de enumeração. Para ver um exemplo, consulte EnumConverter.
Confira também
Aplica-se a
IsValid(Object)
- Origem:
- TypeConverter.cs
- Origem:
- TypeConverter.cs
- Origem:
- TypeConverter.cs
Retorna se o objeto de valor especificado é válido para esse tipo.
public:
bool IsValid(System::Object ^ value);
public bool IsValid (object value);
member this.IsValid : obj -> bool
Public Function IsValid (value As Object) As Boolean
Parâmetros
- value
- Object
O objeto a ser testado quanto à validade.
Retornos
true
se o valor especificado for válido para esse objeto; caso contrário, false
.
Comentários
Começando no .NET Framework 4, o IsValid método captura exceções dos CanConvertFrom métodos e ConvertFrom . Se o tipo de valor de entrada fizer CanConvertFrom com que retorne false
ou se o valor de entrada causar ConvertFrom a geração de uma exceção, o IsValid método retornará false
.
Para habilitar o comportamento herdado, insira as linhas a seguir no arquivo de configuração do aplicativo .NET Framework.
<configuration>
<appSettings>
<add key="UseCompatibleTypeConverterBehavior" value="true" />
</appSettings>
</configuration>
Notas aos Herdeiros
Substitua esse método se o tipo que você deseja converter der suporte a valores padrão que podem ser validados.
O IsValid(Object) método é usado para validar um valor dentro do tipo em vez de determinar se value
pode ser convertido no tipo fornecido. Por exemplo, IsValid(Object) pode ser usado para determinar se um determinado valor é válido para um tipo de enumeração. Para ver um exemplo, consulte EnumConverter.
Você pode escrever seu próprio WillConvertSucceed
método encapsulando os ConvertTo métodos e ConvertFrom em blocos de exceção.