ChartSerializer.Save Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Сохраняет свойства диаграммы, значения которых отличаются от значений по умолчанию. Все свойства диаграммы можно сериализовать, в том числе данные.
Перегрузки
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 Свойства.
Применяется к
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 приложения.
Если этот метод используется для сохранения свойств внешнего вида в качестве шаблона, IsTemplateMode true
перед вызовом этого метода убедитесь, что свойство имеет значение.
Сериализация диаграммы в качестве шаблона выполняется иначе, чем сериализация без шаблона, в основном потому, что сериализация шаблонов сосредоточена на свойствах внешнего вида.
При сериализации шаблона LoadTemplate можно использовать метод для загрузки шаблона, чтобы предоставить свойства внешнего вида для диаграммы.
Шаблоны можно использовать для имитации пользовательских палитр.