ValueSerializer ValueSerializer ValueSerializer ValueSerializer Class

定義

オブジェクト表現からのシリアル化の変換動作を定義する抽象クラス。Abstract class that defines conversion behavior for serialization from an object representation.

public ref class ValueSerializer abstract
public abstract class ValueSerializer
type ValueSerializer = class
Public MustInherit Class ValueSerializer
継承
ValueSerializerValueSerializerValueSerializerValueSerializer
派生

注釈

シリアル化のためのコンバーターを返す文字列は損失のないである必要があり、コンバーターでは、特定の値と同じ文字列を返す必要があります常にします。The string a converter returns for serialization must be loss-less and the converter must always return the same string for a particular value. 型コンバーターの場合 (から派生したTypeConverter) でこれらの要件を満たさないそのConvertTo文字列出力の実装、カスタムValueSerializer宣言する必要があります。If a type converter (derived from TypeConverter) does not meet these requirements in its ConvertTo implementations for string output, a custom ValueSerializer must be declared. いずれか、ValueSerializer要件、または null に満たす必要がありますValueSerializer型を関連付ける必要があります。Either the ValueSerializer should meet the requirements, or a null ValueSerializer should be associated with the type. AValueSerializer適用することで、種類に関連付けられて、ValueSerializerAttribute属性。A ValueSerializer is associated with a type by applying the ValueSerializerAttribute attribute.

NullValueSerializerオブジェクト グラフから文字列への変換の変換の型コンバーターを無視するかを示します。A null ValueSerializer indicates the type converter should be ignored for convert-to-string conversions from the object graph.

重要

実装ValueSerializer例外のスローは避ける必要があります。Implementation of ValueSerializer should avoid throwing exceptions. スローされた例外は、シリアル化を終了でした。Any exceptions thrown could terminate serialization.

IValueSerializerContext ValueSerializerであり、その Api に似ていますITypeDescriptorContextTypeConverterします。IValueSerializerContext for a ValueSerializer and its APIs is analogous to ITypeDescriptorContext for a TypeConverter. 実際、IValueSerializerContext継承ITypeDescriptorContextします。In fact, IValueSerializerContext inherits ITypeDescriptorContext. ときに、ValueSerializer派生クラスの API が呼び出されると、呼び出し元 (通常はシリアライザー プロセス) は、特定のサービスを提供するコンテキストを渡します。When a ValueSerializer derived class API is called, the caller (typically a serializer process) passes a context that may provide certain services. 一般的なガイダンスのためをValueSerializer例外をスローする必要があります。Because of the general guidance that a ValueSerializer must not throw exceptions. エラーを特定のサービスをコンテキストから返す必要がありますも例外をスローしません。Failure to return a particular service from the context must also not throw any exceptions.

.NET Framework の以前のバージョンでは、このクラスは、WPF 固有の WindowsBase アセンブリに存在します。In previous versions of the .NET Framework, this class existed in the WPF-specific assembly WindowsBase. .NET Framework 4.NET Framework 4ValueSerializerは System.Xaml アセンブリにします。In .NET Framework 4.NET Framework 4, ValueSerializer is in the System.Xaml assembly. 詳細については、「 Types Migrated from WPF to System.Xaml」を参照してください。For more information, see Types Migrated from WPF to System.Xaml.

コンストラクター

ValueSerializer() ValueSerializer() ValueSerializer() ValueSerializer()

ValueSerializer クラスの新しいインスタンスを初期化します。Initializes a new instance of the ValueSerializer class.

メソッド

CanConvertFromString(String, IValueSerializerContext) CanConvertFromString(String, IValueSerializerContext) CanConvertFromString(String, IValueSerializerContext) CanConvertFromString(String, IValueSerializerContext)

派生クラスでオーバーライドされたときに、指定した StringValueSerializer の実装でサポートされる型のインスタンスに変換できるかどうか判別します。When overridden in a derived class, determines whether the specified String can be converted to an instance of the type that the implementation of ValueSerializer supports.

CanConvertToString(Object, IValueSerializerContext) CanConvertToString(Object, IValueSerializerContext) CanConvertToString(Object, IValueSerializerContext) CanConvertToString(Object, IValueSerializerContext)

派生クラスでオーバーライドされたとき、指定されたオブジェクトを String に変換できるかどうかを決定します。When overridden in a derived class, determines whether the specified object can be converted into a String.

ConvertFromString(String, IValueSerializerContext) ConvertFromString(String, IValueSerializerContext) ConvertFromString(String, IValueSerializerContext) ConvertFromString(String, IValueSerializerContext)

派生クラスでオーバーライドされると、String を、ValueSerializer の実装でサポートされる型のインスタンスに変換します。When overridden in a derived class, converts a String to an instance of the type that the implementation of ValueSerializer supports.

ConvertToString(Object, IValueSerializerContext) ConvertToString(Object, IValueSerializerContext) ConvertToString(Object, IValueSerializerContext) ConvertToString(Object, IValueSerializerContext)

派生クラスでオーバーライドされた場合は、指定されたオブジェクトを String に変換します。When overridden in a derived class, converts the specified object to a String.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetConvertFromException(Object) GetConvertFromException(Object) GetConvertFromException(Object) GetConvertFromException(Object)

変換を実行できないときにスローする例外を返します。Returns an exception to throw when a conversion cannot be performed.

GetConvertToException(Object, Type) GetConvertToException(Object, Type) GetConvertToException(Object, Type) GetConvertToException(Object, Type)

変換を実行できないときにスローする例外を返します。Returns an exception to throw when a conversion cannot be performed.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetSerializerFor(PropertyDescriptor) GetSerializerFor(PropertyDescriptor) GetSerializerFor(PropertyDescriptor) GetSerializerFor(PropertyDescriptor)

プロパティの CLR プロパティ記述子を渡すことで、プロパティに対して宣言された ValueSerializer を取得します。Gets the ValueSerializer declared for a property, by passing a CLR property descriptor for the property.

GetSerializerFor(PropertyDescriptor, IValueSerializerContext) GetSerializerFor(PropertyDescriptor, IValueSerializerContext) GetSerializerFor(PropertyDescriptor, IValueSerializerContext) GetSerializerFor(PropertyDescriptor, IValueSerializerContext)

指定したコンテキストを使って、指定したプロパティに対して宣言された ValueSerializer を取得します。Gets the ValueSerializer declared for the specified property, using the specified context.

GetSerializerFor(Type) GetSerializerFor(Type) GetSerializerFor(Type) GetSerializerFor(Type)

指定した型に宣言された ValueSerializer を取得します。Gets the ValueSerializer declared for the specified type.

GetSerializerFor(Type, IValueSerializerContext) GetSerializerFor(Type, IValueSerializerContext) GetSerializerFor(Type, IValueSerializerContext) GetSerializerFor(Type, IValueSerializerContext)

指定したコンテキストを使用して、指定された型に宣言されている ValueSerializer を取得します。Gets the ValueSerializer declared for the specified type, using the specified context.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)
TypeReferences(Object, IValueSerializerContext) TypeReferences(Object, IValueSerializerContext) TypeReferences(Object, IValueSerializerContext) TypeReferences(Object, IValueSerializerContext)

ValueSerializer によって参照される型の列挙体を取得します。Gets an enumeration of the types referenced by the ValueSerializer.

適用対象

こちらもご覧ください