ChartSerializer Класс

Определение

Пространство имен:

System.Windows.Forms.DataVisualization.Charting

Сборка:

System.Windows.Forms.DataVisualization.dll

Включает сериализацию элемента управления Chart.

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 сериализуются автоматически. Затем сериализованные данные применяются к существующим областям диаграммы и рядам при загрузке.

Важно!

Свойство Content реализуется внутри элемента управления как ChartSerializableContent свойство

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

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

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

Свойства

Content	Получает или задает тип подлежащего сериализации содержимого диаграммы.
Format	Получает или задает формат, используемый при сериализации диаграммы.
IsResetWhenLoading	Получает или задает флаг, определяющий, нужно ли перед загрузкой установить для свойств объекта значения по умолчанию.
IsTemplateMode	Получает или задает флаг, указывающий, работает ли сериализатор диаграмм в режиме создания шаблона.
IsUnknownAttributeIgnored	Получает или задает флаг, указывающий, будут ли неизвестные элементы и свойства XML пропускаться без создания исключения.
NonSerializableContent	Получает или задает свойства диаграммы, которые не будут сериализованы.
SerializableContent	Получает или задает свойства диаграммы, которые можно сериализовать.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetContentString(SerializationContents, Boolean)	Возвращает сериализуемые или несериализуемые имена классов и свойств в зависимости от значения флага.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
Load(Stream)	Загружает в элемент управления сериализованные данные из объекта класса, производного от Stream.
Load(String)	Загружает сохраненные на диске сериализованные данные в элемент управления Chart.
Load(TextReader)	Загружает в элемент управления сериализованные данные из объекта чтения, который относится к классу, производному от класса TextReader.
Load(XmlReader)	Загружает в элемент управления сериализованные данные из объекта класса, производного от XmlReader.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Reset()	Сбрасывает все свойства диаграммы, помеченные для сериализации.
Save(Stream)	Сохраняет данные и свойства диаграммы, значения которых отличаются от значений по умолчанию, в объекте класса, производного от Stream.
Save(String)	Сохраняет данные и свойства диаграммы, значения которых отличаются от значений по умолчанию, в указанный файл.
Save(TextWriter)	Сохраняет данные и свойства диаграммы, значения которых отличаются от значений по умолчанию, в заданном объекте класса, производного от TextWriter.
Save(XmlWriter)	Сохраняет данные и свойства диаграммы, значения которых отличаются от значений по умолчанию, в заданном объекте класса, производного от XmlWriter.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)