ValueSerializer 클래스

정의

개체 표현에서 serialization의 변환 동작을 정의하는 추상 클래스입니다.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
상속
ValueSerializer
파생

설명

Serialization에 대 한 변환기를 반환 하는 문자열 손실 없이 고 변환기 항상 특정 값에 대 한 동일한 문자열을 반환 해야 합니다.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. ValueSerializer ValueSerializerAttribute 특성을 적용 하 여 형식과 연결 됩니다.A ValueSerializer is associated with a type by applying the ValueSerializerAttribute attribute.

Null ValueSerializer는 개체 그래프에서 문자열 변환 변환에 대 한 형식 변환기가 무시 되어야 함을 나타냅니다.A null ValueSerializer indicates the type converter should be ignored for convert-to-string conversions from the object graph.

중요

ValueSerializer 구현 시 예외가 throw 되는 것을 방지 해야 합니다.Implementation of ValueSerializer should avoid throwing exceptions. Throw 된 예외 직렬화를 종료할 수 없습니다.Any exceptions thrown could terminate serialization.

ValueSerializer 및 해당 Api에 대 한 IValueSerializerContext TypeConverter에 대 한 ITypeDescriptorContext와 유사 합니다.IValueSerializerContext for a ValueSerializer and its APIs is analogous to ITypeDescriptorContext for a TypeConverter. 실제로 IValueSerializerContextITypeDescriptorContext를 상속 합니다.In fact, IValueSerializerContext inherits ITypeDescriptorContext. ValueSerializer 파생 클래스 API를 호출 하는 경우 호출자 (일반적으로 serializer 프로세스)는 특정 서비스를 제공할 수 있는 컨텍스트를 전달 합니다.When a ValueSerializer derived class API is called, the caller (typically a serializer process) passes a context that may provide certain services. ValueSerializer는 예외를 throw 하지 않아야 하는 일반적인 지침 때문입니다.Because of the general guidance that a ValueSerializer must not throw exceptions. 컨텍스트에서 특정 서비스를 반환 하는 오류 예외도 throw 하지 해야 합니다.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 4, ValueSerializer 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 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ValueSerializer class.

메서드

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)

파생 클래스에서 재정의되는 경우 지정된 개체가 String으로 변환될 수 있는지 여부를 결정합니다.When overridden in a derived class, determines whether the specified object can be converted into a String.

ConvertFromString(String, IValueSerializerContext)

파생 클래스에서 재정의된 경우 StringValueSerializer 구현에서 지원하는 형식의 인스턴스로 변환합니다.When overridden in a derived class, converts a String to an instance of the type that the implementation of ValueSerializer supports.

ConvertToString(Object, IValueSerializerContext)

파생 클래스에서 재정의된 경우 지정된 개체를 String으로 변환합니다.When overridden in a derived class, converts the specified object to a String.

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetConvertFromException(Object)

변환을 수행할 수 없을 때 발생하는 예외를 반환합니다.Returns an exception to throw when a conversion cannot be performed.

GetConvertToException(Object, Type)

변환을 수행할 수 없을 때 발생하는 예외를 반환합니다.Returns an exception to throw when a conversion cannot be performed.

GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetSerializerFor(PropertyDescriptor)

속성에 대한 CLR 속성 설명자를 전달하여 속성에 대해 선언된 ValueSerializer를 가져옵니다.Gets the ValueSerializer declared for a property, by passing a CLR property descriptor for the property.

GetSerializerFor(PropertyDescriptor, IValueSerializerContext)

지정된 컨텍스트를 사용하여 지정된 속성에 대해 선언된 ValueSerializer를 가져옵니다.Gets the ValueSerializer declared for the specified property, using the specified context.

GetSerializerFor(Type)

지정된 형식에 대해 선언된 ValueSerializer를 가져옵니다.Gets the ValueSerializer declared for the specified type.

GetSerializerFor(Type, IValueSerializerContext)

지정된 컨텍스트를 사용하여 지정된 형식에 대해 선언된 ValueSerializer를 가져옵니다.Gets the ValueSerializer declared for the specified type, using the specified context.

GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)
TypeReferences(Object, IValueSerializerContext)

ValueSerializer에서 참조되는 형식의 열거형을 가져옵니다.Gets an enumeration of the types referenced by the ValueSerializer.

적용 대상

추가 정보