TypeConverter.IsValid 方法

定義

回傳給定值物件是否適用於此類型。

多載

名稱 Description
IsValid(ITypeDescriptorContext, Object)

回傳給定值物件是否適用於此類型及指定上下文。

IsValid(Object)

回傳給定值物件是否適用於此類型。

IsValid(ITypeDescriptorContext, Object)

回傳給定值物件是否適用於此類型及指定上下文。

public:
 virtual bool IsValid(System::ComponentModel::ITypeDescriptorContext ^ context, System::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

參數

context
ITypeDescriptorContext

提供格式背景的一個 ITypeDescriptorContext

value
Object

用來 Object 測試其效度。

傳回

true若指定值對該物件有效;否則,。 false

範例

關於此函數的範例,請參見類別。TypeConverter

備註

利用參數 context 擷取關於該轉換器所使用的環境的額外資訊。 這個參數可以是 null,所以一定要檢查。 此外,上下文物件上的屬性也可以回傳 null

從 .NET Framework 4 開始,IsValid 方法會捕捉來自 CanConvertFromConvertFrom 方法的例外。 若輸入值類型導致 CanConvertFrom 回傳 false,或輸入值引發 ConvertFrom 例外, IsValid 則該方法回傳 false

要啟用舊有行為,請在你的 .NET Framework 應用程式的設定檔中插入以下幾行。

<configuration>
  <appSettings>
    <add key="UseCompatibleTypeConverterBehavior" value="true" />
  </appSettings>
</configuration>

給繼承者的注意事項

如果你想轉換的型別支援可驗證的標準值,則可覆寫此方法。

IsValid(ITypeDescriptorContext, Object) 方法用於驗證型別內的值,而非判斷是否 value 能轉換為該型別。 例如, IsValid(ITypeDescriptorContext, Object) 可以用來判斷某個值是否適用於某個列舉類型。 如需範例,請參閱 EnumConverter

另請參閱

適用於

IsValid(Object)

回傳給定值物件是否適用於此類型。

public:
 bool IsValid(System::Object ^ value);
public bool IsValid(object value);
member this.IsValid : obj -> bool
Public Function IsValid (value As Object) As Boolean

參數

value
Object

用來檢驗其效度的物件。

傳回

true若指定值對該物件有效;否則,。 false

備註

從 .NET Framework 4 開始,IsValid 方法會捕捉來自 CanConvertFromConvertFrom 方法的例外。 若輸入值類型導致 CanConvertFrom 回傳 false,或輸入值引發 ConvertFrom 例外, IsValid 則該方法回傳 false

要啟用舊有行為,請在你的 .NET Framework 應用程式的設定檔中插入以下幾行。

<configuration>
  <appSettings>
    <add key="UseCompatibleTypeConverterBehavior" value="true" />
  </appSettings>
</configuration>

給繼承者的注意事項

如果你想轉換的型別支援可驗證的標準值,則可覆寫此方法。

IsValid(Object) 方法用於驗證型別內的值,而非判斷是否 value 能轉換為該型別。 例如, IsValid(Object) 可以用來判斷某個值是否適用於某個列舉類型。 如需範例,請參閱 EnumConverter

你可以自己寫 WillConvertSucceed 方法,方法是用 ConvertTo 例外區塊包裹 and ConvertFrom 方法。

另請參閱

適用於