ValueSerializer 類別

  • 參考

定義

命名空間:
System.Windows.Markup
組件:
WindowsBase.dll
組件:
System.Xaml.dll

抽象類別，其定義從物件表示進行序列化的轉換行為。

public ref class ValueSerializer abstract
public abstract class ValueSerializer
type ValueSerializer = class
Public MustInherit Class ValueSerializer
繼承
Object
ValueSerializer
衍生

備註

轉換器針對串行化所傳回的字串必須不遺失，而且轉換器必須一律針對特定值傳回相同的字串。 如果衍生自 TypeConverter) 的類型 (轉換器在字串輸出的實作中 ConvertTo 不符合這些需求，則必須宣告自定義 ValueSerializer 。 ValueSerializer應該符合需求，或 Null ValueSerializer 應該與型別相關聯。 透過 ValueSerializer 套用 ValueSerializerAttribute 屬性，與型別相關聯。

Null ValueSerializer 表示應該忽略物件圖形中轉換字串轉換的類型轉換子。

重要

實作 ValueSerializer 應該避免擲回例外狀況。 擲回的任何例外狀況都可以終止串行化。

IValueSerializerContextValueSerializer的與 API 類似於 ITypeDescriptorContextTypeConverter。 事實上， IValueSerializerContext 繼承 ITypeDescriptorContext。 ValueSerializer呼叫衍生類別 API 時，呼叫端通常會 (串行化程式程式) 傳遞可提供特定服務的內容。 由於的一般指引，因此 ValueSerializer 不得擲回例外狀況。 無法從內容傳回特定服務，也不得擲回任何例外狀況。

在舊版的 .NET Framework 中，這個類別存在於 WPF 特定的元件 WindowsBase 中。 在 .NET Framework 4 中，ValueSerializer位於 System.Xaml 元件中。 如需詳細資訊，請參閱 Types Migrated from WPF to System.Xaml。

建構函式

ValueSerializer()

初始化 ValueSerializer 類別的新執行個體。

方法

CanConvertFromString(String, IValueSerializerContext)

在衍生類別中覆寫時，判斷是否可以將指定的 String 轉換成 ValueSerializer 的實作所支援之類型的執行個體。
CanConvertToString(Object, IValueSerializerContext)

在衍生類別中覆寫時，判斷指定的物件是否可以轉換成 String。
ConvertFromString(String, IValueSerializerContext)

在衍生類別中覆寫時，將 String 轉換成 ValueSerializer 的實作所支援之類型的執行個體。
ConvertToString(Object, IValueSerializerContext)

在衍生類別中覆寫時，將指定的物件轉換成 String。
Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetConvertFromException(Object)

傳回要在無法執行轉換時擲回的例外狀況。
GetConvertToException(Object, Type)

傳回要在無法執行轉換時擲回的例外狀況。
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetSerializerFor(PropertyDescriptor)

透過傳遞屬性的 CLR 屬性描述元，取得針對屬性所宣告的 ValueSerializer。
GetSerializerFor(PropertyDescriptor, IValueSerializerContext)

使用指定的內容，取得為指定屬性宣告的 ValueSerializer。
GetSerializerFor(Type)

取得為指定類型宣告的 ValueSerializer。
GetSerializerFor(Type, IValueSerializerContext)

使用指定的內容，取得為指定類型宣告的 ValueSerializer。
GetType()

取得目前執行個體的 Type。

(繼承來源 Object)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)
TypeReferences(Object, IValueSerializerContext)

取得 ValueSerializer 所參考類型的列舉。

適用於

另請參閱