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. A ValueSerializer 적용 하 여 형식과 연결 됩니다는 ValueSerializerAttribute 특성입니다.A ValueSerializer is associated with a type by applying the ValueSerializerAttribute attribute.

Null ValueSerializer convert를 문자열로 변환할 개체 그래프에 대 한 형식 변환기를 무시할지를 나타냅니다.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.

IValueSerializerContextValueSerializer 및 해당 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 호출 되 면 호출자 (일반적으로 직렬 변환기 프로세스)는 특정 서비스를 제공할 수 있는 컨텍스트를 전달 합니다.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. 컨텍스트에서 특정 서비스를 반환 하는 오류 예외도 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)

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

GetConvertToException(Object, Type)

변환을 수행할 수 없을 때 throw되는 예외를 반환합니다.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()

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

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

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

적용 대상

추가 정보