ChartSerializer.Save Метод

Определение

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

System.Web.UI.DataVisualization.Charting

Сборка:

System.Web.DataVisualization.dll

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

Перегрузки

Save(XmlWriter)	Сохраняет данные и свойства диаграммы, значения которых отличаются от значений по умолчанию, в заданном объекте класса, производного от XmlWriter.
Save(Stream)	Сохраняет данные и свойства диаграммы, значения которых отличаются от значений по умолчанию, в объекте класса, производного от Stream.
Save(TextWriter)	Сохраняет данные и свойства диаграммы, значения которых отличаются от значений по умолчанию, в заданном объекте класса, производного от TextWriter.
Save(String)	Сохраняет данные и свойства диаграммы, значения которых отличаются от значений по умолчанию, в указанный файл.

Save(XmlWriter)

Сохраняет данные и свойства диаграммы, значения которых отличаются от значений по умолчанию, в заданном объекте класса, производного от XmlWriter.

public:
 void Save(System::Xml::XmlWriter ^ writer);

public void Save (System.Xml.XmlWriter writer);

member this.Save : System.Xml.XmlWriter -> unit

Public Sub Save (writer As XmlWriter)

Параметры

writer

XmlWriter

Объект, производный от класса XmlWriter, который используется для сохранения свойств объекта Chart.

Комментарии

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

При использовании этого определения формат должен иметь формат XML; Формат можно изменить с помощью Format свойства .

При работе с текстовыми файлами формата XML для простоты Save используйте метод .

Save(Stream)

Сохраняет данные и свойства диаграммы, значения которых отличаются от значений по умолчанию, в объекте класса, производного от Stream.

public:
 void Save(System::IO::Stream ^ stream);

public void Save (System.IO.Stream stream);

member this.Save : System.IO.Stream -> unit

Public Sub Save (stream As Stream)

Параметры

stream

Stream

Объект класса, производного от Stream, например MemoryStream, который служит для сохранения свойств диаграммы.

Комментарии

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

Если этот метод используется для сохранения свойств внешнего вида в виде шаблона, перед вызовом этого метода убедитесь, что IsTemplateMode свойству ChartSerializer объекта присвоено значение true .

Сериализация диаграммы в качестве шаблона происходит иначе, чем сериализация без шаблона; Сериализация шаблонов сосредоточена на свойствах внешнего вида.

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

Шаблоны можно использовать для имитации пользовательских палитр.

Save(TextWriter)

Сохраняет данные и свойства диаграммы, значения которых отличаются от значений по умолчанию, в заданном объекте класса, производного от TextWriter.

public:
 void Save(System::IO::TextWriter ^ writer);

public void Save (System.IO.TextWriter writer);

member this.Save : System.IO.TextWriter -> unit

Public Sub Save (writer As TextWriter)

Параметры

writer

TextWriter

Объект класса, производного от TextWriter, например StringWriter, который служит для сохранения свойств диаграммы.

Комментарии

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

При использовании этого определения формат должен иметь формат XML; формат можно задать с помощью Format свойства .

ViewStateData Если свойство Chart элемента управления используется для сохранения состояния, этот метод можно использовать для сохранения сериализованных данных в объекте, производном от TextWriter, который затем используется для записи данных в ViewStateData свойство .

Save(String)

Сохраняет данные и свойства диаграммы, значения которых отличаются от значений по умолчанию, в указанный файл.

public:
 void Save(System::String ^ fileName);

public void Save (string fileName);

member this.Save : string -> unit

Public Sub Save (fileName As String)

Параметры

fileName

String

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

Комментарии

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

По умолчанию данные сохраняются в формате XML. Чтобы сохранить данные в двоичном формате, используйте Format свойство .

Обратите внимание, что для каталога, в котором хранится файл, должны быть включены разрешения на запись. По умолчанию это папка Bin приложения.

Если этот метод используется для сохранения свойств Appearance в качестве шаблона, перед вызовом этого метода убедитесь, что IsTemplateMode для свойства задано значение true .

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

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

Шаблоны можно использовать для имитации пользовательских палитр.