ValueSerializer Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Абстрактный класс, который определяет поведение преобразования для сериализации из представления объекта.
public ref class ValueSerializer abstract
public abstract class ValueSerializer
type ValueSerializer = class
Public MustInherit Class ValueSerializer
- Наследование
-
ValueSerializer
- Производный
Комментарии
Строка, возвращаемая преобразователем для сериализации, должна быть без потерь, а преобразователь должен всегда возвращать одну и ту же строку для определенного значения. Если преобразователь типов (производный от TypeConverter) не соответствует этим требованиям в своих ConvertTo
реализациях для вывода строк, необходимо объявить пользовательский ValueSerializer .
ValueSerializer Либо должен соответствовать требованиям, либо значение NULL ValueSerializer должно быть связано с типом. Объект ValueSerializer связан с типом путем применения атрибута ValueSerializerAttribute .
Значение NULL ValueSerializer указывает, что преобразователь типов следует игнорировать при преобразовании в строку из графа объектов.
Важно!
Реализация должна избегать ValueSerializer создания исключений. Любые исключения могут завершить сериализацию.
IValueSerializerContext ValueSerializer для и его API аналогина ITypeDescriptorContext для для TypeConverter. Фактически наследует IValueSerializerContextITypeDescriptorContext. При вызове API производного ValueSerializer класса вызывающий объект (обычно процесс сериализатора) передает контекст, который может предоставлять определенные службы. Из-за общих рекомендаций ValueSerializer , что не должен вызывать исключения. Сбой при возврате определенной службы из контекста также не должен вызывать никаких исключений.
В предыдущих версиях платформа .NET Framework этот класс существовал в сборке WindowsBase для WPF. В платформа .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) |
Возвращает объект ValueSerializer, объявленный для свойства, передавая дескриптор свойства CLR для свойства. |
GetSerializerFor(PropertyDescriptor, IValueSerializerContext) |
Получает объявленный ValueSerializer для указанного свойства, используя заданный контекст. |
GetSerializerFor(Type) |
Получает ValueSerializer, объявленный для указанного типа. |
GetSerializerFor(Type, IValueSerializerContext) |
Получает объект ValueSerializer, объявленный для указанного типа, используя заданный контекст. |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
TypeReferences(Object, IValueSerializerContext) |
Получает перечисление типов, на которые ссылается ValueSerializer. |