ValueSerializer 클래스

정의

개체 표현에서 직렬화하기 위한 변환 동작을 정의하는 추상 클래스입니다.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
파생

설명

직렬화를 위해 변환기에서 반환 하는 문자열은 손실 되지 않아야 하며 변환기는 항상 특정 값에 대해 동일한 문자열을 반환 해야 합니다.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 된 모든 예외는 serialization을 종료할 수 있습니다.Any exceptions thrown could terminate serialization.

IValueSerializerContext및의 ValueSerializer api는의 경우와 유사 ITypeDescriptorContext TypeConverter 합니다.IValueSerializerContext for a ValueSerializer and its APIs is analogous to ITypeDescriptorContext for a TypeConverter. 실제로는를 IValueSerializerContext 상속 ITypeDescriptorContext 합니다.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.

적용 대상

추가 정보