ChartSerializer.SerializableContent Свойство

Определение

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

System.Windows.Forms.DataVisualization.Charting

Сборка:

System.Windows.Forms.DataVisualization.dll

Получает или задает свойства диаграммы, которые можно сериализовать.

public:
 property System::String ^ SerializableContent { System::String ^ get(); void set(System::String ^ value); };

public string SerializableContent { get; set; }

member this.SerializableContent : string with get, set

Public Property SerializableContent As String

Значение свойства

String

Выражение типа string с разделенными запятыми значениями, представляющее свойства диаграммы, которые подлежат сериализации. Используется синтаксис "Класс.Свойство[,Класс.Свойство]".

Комментарии

По умолчанию все свойства диаграммы будут сериализованы при вызове Save методов и Load . Свойство можно использовать для NonSerializableContent ограничения сериализуемых характеристик диаграммы вместе со свойствами SerializableContent и Content .

Свойство SerializableContent определяет, какие характеристики диаграммы будут сериализованы. Подстановочные знаки можно использовать в строковом выражении так же, как и NonSerializableContent свойство . Например, чтобы сериализовать все свойства диаграммы BackColor , присвойте этому свойству значение "*. BackColor".

Если ChartArea указаны и (или) Series дочерние свойства, необходимо также указать имена всех ChartArea объектов и , Series чтобы обеспечить применение сохраненных данных к существующим ChartArea объектам и Series ; то есть необходимо указать выражения "Series.Name" и "ChartArea.Name". Пример этой процедуры см. в примере кода ниже. Аналогичным образом, если используется несколько областей диаграммы, ChartArea необходимо также сохранить свойство всех объектов Series .

Иногда свойство может быть как сериализованным, так и не сериализованным, что является распространенным при использовании подстановочных знаков. Выражение NonSerializableContent имеет более низкий приоритет по сравнению с выражением SerializableContent . Однако обратите внимание, что для строковых выражений, использующих подстановочные знаки, придается меньший вес. Например, если свойству SerializableContent присвоено значение "*. BackColor" и NonSerializableContent свойство имеет значение BackColor, все свойства BackColor , кроме ChartArea объектов , будут сериализованы.

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

Это свойство влияет на все операции сохранения, загрузки и сброса.