XamlServices.Save Метод

Определение

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

System.Xaml

Сборка:

System.Xaml.dll

Преобразует предоставленный граф объектов в представление узлов XAML, а затем в выходной формат для сериализации.

Перегрузки

Save(Object)	Преобразует предоставленное дерево объектов в представление узлов XAML и возвращает строковое представление выходного кода XAML.
Save(Stream, Object)	Преобразует предоставленный граф объектов в представление узлов XAML, а затем в выходной поток для сериализации.
Save(TextWriter, Object)	Преобразует предоставленный граф объектов в представление узлов XAML, а затем в выходные данные, передаваемые предоставленному объекту TextWriter.
Save(String, Object)	Преобразует предоставленный граф объектов в представление узлов XAML, а затем записывает его в выходной файл в указанном расположении.
Save(XamlWriter, Object)	Преобразует предоставленный граф объектов в представление узлов XAML, а затем записывает его в предоставленное средство записи XAML.
Save(XmlWriter, Object)	Преобразует предоставленный граф объектов в представление узлов XAML, а затем записывает его в предоставленный объект XmlWriter.

Save(Object)

Преобразует предоставленное дерево объектов в представление узлов XAML и возвращает строковое представление выходного кода XAML.

public:
 static System::String ^ Save(System::Object ^ instance);

public static string Save (object instance);

static member Save : obj -> string

Public Shared Function Save (instance As Object) As String

Параметры

instance

Object

Корень обрабатываемого графа объектов.

Возвращаемое значение

String

Разметка XAML, выводимая в виде строки.

Комментарии

Выходные данные этого метода являются ToString результатом XmlWriter вызова метода. Это XmlWriter создается с помощью следующих параметров: XmlWriterSettings.Indent is true; and XmlWriterSettings.OmitXmlDeclaration is true.

Возвращаемую строку можно загрузить как допустимый XML-код с помощью Create метода, если вы обработали строку в потоке или в средство чтения, специально выделенное для XAML.

Save(Stream, Object)

Преобразует предоставленный граф объектов в представление узлов XAML, а затем в выходной поток для сериализации.

public:
 static void Save(System::IO::Stream ^ stream, System::Object ^ instance);

public static void Save (System.IO.Stream stream, object instance);

static member Save : System.IO.Stream * obj -> unit

Public Shared Sub Save (stream As Stream, instance As Object)

Параметры

stream

Stream

Конечный поток.

instance

Object

Корень обрабатываемого графа объектов.

Исключения

ArgumentNullException

Входное значение stream равно null.

Комментарии

Важно!

XamlServicesНе рекомендуется выполнять чтение XAML или набор API записи XAML, если вы обрабатываете типы Windows Presentation Foundation (WPF) или типы на основе WPF. Для использования WPF используйте System.Windows.Markup.XamlReader для чтения или загрузки XAML, а также System.Windows.Markup.XamlWriter для обратной записи XAML. Эти классы используют System.Xaml API внутри своей реализации. Однако они также обеспечивают поддержку конкретных концепций WPF, влияющих на характер чтения и записи XAML, таких как оптимизация свойств зависимостей.

Save(TextWriter, Object)

Преобразует предоставленный граф объектов в представление узлов XAML, а затем в выходные данные, передаваемые предоставленному объекту TextWriter.

public:
 static void Save(System::IO::TextWriter ^ writer, System::Object ^ instance);

public static void Save (System.IO.TextWriter writer, object instance);

static member Save : System.IO.TextWriter * obj -> unit

Public Shared Sub Save (writer As TextWriter, instance As Object)

Параметры

writer

TextWriter

Объект TextWriter, записывающий выходные данные.

instance

Object

Корень обрабатываемого графа объектов.

Исключения

ArgumentNullException

Входное значение writer равно null.

Save(String, Object)

Преобразует предоставленный граф объектов в представление узлов XAML, а затем записывает его в выходной файл в указанном расположении.

public:
 static void Save(System::String ^ fileName, System::Object ^ instance);

public static void Save (string fileName, object instance);

static member Save : string * obj -> unit

Public Shared Sub Save (fileName As String, instance As Object)

Параметры

fileName

String

Имя и расположение файла, в который записываются выходные данные.

instance

Object

Корень обрабатываемого графа объектов.

Исключения

ArgumentException

Параметр fileName равен пустой строке.

ArgumentNullException

fileName имеет значение null.

Комментарии

Значение fileName параметра используется в качестве outputFileName входных данных для вызова XmlWriter.Create, который создает как XmlWriter часть вызова метода.

Save(XamlWriter, Object)

Преобразует предоставленный граф объектов в представление узлов XAML, а затем записывает его в предоставленное средство записи XAML.

public:
 static void Save(System::Xaml::XamlWriter ^ writer, System::Object ^ instance);

public static void Save (System.Xaml.XamlWriter writer, object instance);

static member Save : System.Xaml.XamlWriter * obj -> unit

Public Shared Sub Save (writer As XamlWriter, instance As Object)

Параметры

writer

XamlWriter

Используемая реализация объекта XamlWriter.

instance

Object

Корень обрабатываемого графа объектов.

Исключения

ArgumentNullException

Входное значение writer равно null.

Комментарии

Обычно эту сигнатуру следует использовать только в следующих случаях:

• Вы определили собственную реализацию объекта XamlWriter.

• Вы указали параметры, XamlWriter отличающиеся от параметров по умолчанию.

Save(XmlWriter, Object)

Преобразует предоставленный граф объектов в представление узлов XAML, а затем записывает его в предоставленный объект XmlWriter.

public:
 static void Save(System::Xml::XmlWriter ^ writer, System::Object ^ instance);

public static void Save (System.Xml.XmlWriter writer, object instance);

static member Save : System.Xml.XmlWriter * obj -> unit

Public Shared Sub Save (writer As XmlWriter, instance As Object)

Параметры

writer

XmlWriter

Используемая реализация объекта XmlWriter.

instance

Object

Корень обрабатываемого графа объектов.

Исключения

ArgumentNullException

Входное значение writer равно null.