TypeConverter.IsValid 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
回傳給定值物件是否適用於此類型。
多載
| 名稱 | 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 。
傳回
true若指定值對該物件有效;否則,。 false
範例
關於此函數的範例,請參見類別。TypeConverter
備註
利用參數 context 擷取關於該轉換器所使用的環境的額外資訊。 這個參數可以是 null,所以一定要檢查。 此外,上下文物件上的屬性也可以回傳 null。
從 .NET Framework 4 開始,IsValid 方法會捕捉來自 CanConvertFrom 和 ConvertFrom 方法的例外。 若輸入值類型導致 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 方法會捕捉來自 CanConvertFrom 和 ConvertFrom 方法的例外。 若輸入值類型導致 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 方法。