英語で読む

次の方法で共有

ValueSerializer クラス

  • リファレンス

定義

名前空間:
System.Windows.Markup
アセンブリ:
WindowsBase.dll
アセンブリ:
System.Xaml.dll

オブジェクト表現からのシリアル化の変換動作を定義する抽象クラス。

C# 
public abstract class ValueSerializer
継承
Object
ValueSerializer
派生

注釈

コンバーターがシリアル化のために返す文字列は損失が少なく、コンバーターは常に特定の値に対して同じ文字列を返す必要があります。 (から TypeConverter派生した) 型コンバーターが文字列出力の実装でこれらの要件を ConvertTo 満たしていない場合は、カスタム ValueSerializer を宣言する必要があります。 は ValueSerializer 要件を満たす必要があります。または、null を ValueSerializer 型に関連付ける必要があります。 ValueSerializerは、 属性を適用して型にValueSerializerAttribute関連付けられます。

null は ValueSerializer 、オブジェクト グラフからの文字列変換変換では、型コンバーターを無視する必要があることを示します。

重要

の ValueSerializer 実装では、例外がスローされないようにする必要があります。 スローされた例外は、シリアル化を終了する可能性があります。

IValueSerializerContext ValueSerializerとその 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 によって参照される型の列挙体を取得します。

適用対象

製品 バージョン
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

こちらもご覧ください