ChartSerializer Класс

Определение

public ref class ChartSerializer

public class ChartSerializer

type ChartSerializer = class

Public Class ChartSerializer

Наследование

Object

ChartSerializer

Комментарии

Этот класс предоставляется как Serializer свойство корневого Chart класса.

Сериализация сохраняет состояние диаграммы, а также предоставляет возможность загрузки сериализованных данных в диаграмму. Все свойства диаграммы могут быть сохранены, включая данные диаграммы. Кроме того, можно сбросить все свойства диаграммы, помеченные для сериализации.

Этот класс при необходимости можно использовать при управлении состоянием определяемого пользователем представления. Один из его Load методов можно использовать для загрузки состояния представления, а один из Save методов можно использовать при настройке состояния представления.

Для хранения сериализованных данных можно использовать XML- или двоичные форматы. Xml используется по умолчанию, но формат можно изменить с помощью Format свойства .

Свойства диаграммы сохраняются и загружаются с помощью Save методов и Load соответственно. Обратите внимание, что будут сохранены только свойства со значениями, отличными от значений по умолчанию. Данные можно сохранять и (или) загружать с помощью объектов file, stream, TextWriter, TextReaderXmlWriter и XmlReader . При сохранении и (или) загрузке данных с помощью объекта, производного от TextReaderклассов , TextWriterXmlReader или XmlWriter , формат данных должен быть XML.

В следующем списке описаны три метода, от базового до расширенного, используемые для определения сериализуемых данных. Обратите внимание, что также можно определить несериализируемые данные. Этот метод описан в следующем абзаце.

• Сериализуйте Chart с помощью Save методов и Load без указания сериализуемых свойств. Все свойства диаграммы со значениями, не используемыми по умолчанию, включая данные диаграммы, будут сериализованы.

• Сериализация свойств диаграммы, заданных свойством Content . Свойство Content группизирует свойства диаграммы для сериализации по таким категориям, как Данные, Внешний вид и т. д. Обратите внимание, что имена ChartArea объектов и Series сериализуются автоматически. Затем сериализованные данные применяются к существующим областям диаграммы и рядам при загрузке.

• Сериализация свойств диаграммы, заданных свойством .SerializableContent Это разделенный запятыми список всех свойств диаграммы, которые можно сериализовать. После того как этому свойству присвоено явное значение, разработчик должен указать все свойства, которые будут сохранены. Другими словами, в Content отличие от свойства , имена областей диаграммы и рядов не будут сохраняться автоматически. Свойства Content и SerializableContent также можно использовать в сочетании. Однако убедитесь, что SerializableContent он сцеплен с самим собой при установке, в противном случае свойства диаграммы, заданные свойством Content , будут переопределены.

Чтобы запретить сериализацию определенных свойств, используйте NonSerializableContent свойство . Если одно свойство задано как сериализуемое и несериализируемое, что часто встречается при использовании подстановочных знаков, SerializableContent свойство имеет приоритет. Однако приоритет также зависит от того, сколько подстановочных знаков было использовано при указании свойства.

По умолчанию сериализуемые свойства сбрасываются до значений по умолчанию перед загрузкой. Это поведение можно изменить с помощью IsResetWhenLoading свойства . Метод Reset также можно использовать для явного сброса свойств диаграммы до значений по умолчанию.

Свойства

Методы

Применяется к