ChartSerializer Класс

Определение

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

System.Web.UI.DataVisualization.Charting

Сборка:

System.Web.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 методов. Обратите внимание, что будут сохранены только свойства, не имеющие значения по умолчанию. Данные можно сохранять и (или) загружать с помощью файла, потока, TextWriterTextReaderXmlWriter и XmlReader объектов. При сохранении и (или) загрузке данных с помощью объекта, производного от TextReaderTextWriterкласса или XmlReaderXmlWriter класса, формат данных должен быть XML.

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

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

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

Это важно

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

• Сериализация свойств диаграммы, указанных свойством SerializableContent . Это разделенный запятыми список всех свойств диаграммы, которые являются сериализуемыми. После того как это свойство имеет явное значение, разработчик должен указать все свойства, которые необходимо сохранить. Другими словами, в отличие от Content свойства, имена областей диаграмм и рядов не будут автоматически сохраняться. SerializableContent Свойства Content также можно использовать в сочетании. Тем не менее убедитесь, что 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)