XmlDataSource

XmlDataSource class

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

public class XmlDataSource

Конструкторы

Имя Описание
XmlDataSource(Stream) Создает новый источник данных с данными из потока XML, используя параметры по умолчанию для загрузки данных XML.
XmlDataSource(string) Создает новый источник данных с данными из файла XML, используя параметры по умолчанию для загрузки данных XML.
XmlDataSource(Stream, Stream) Создает новый источник данных с данными из потока XML с использованием потока определения схемы XML. Параметры по умолчанию используются для загрузки данных XML.
XmlDataSource(Stream, XmlDataLoadOptions) Создает новый источник данных с данными из потока XML, используя указанные параметры загрузки данных XML.
XmlDataSource(string, string) Создает новый источник данных с данными из файла XML, используя файл определения схемы XML. Параметры по умолчанию используются для загрузки данных XML.
XmlDataSource(string, XmlDataLoadOptions) Создает новый источник данных с данными из файла XML, используя указанные параметры загрузки данных XML.
XmlDataSource(Stream, Stream, XmlDataLoadOptions) Создает новый источник данных с данными из потока XML с использованием потока определения схемы XML. Указанные параметры используются для загрузки XML-данных.
XmlDataSource(string, string, XmlDataLoadOptions) Создает новый источник данных с данными из файла XML, используя файл определения схемы XML. Указанные параметры используются для загрузки XML-данных.

Примечания

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

В шаблонных документах, если XML-элемент верхнего уровня содержит только список элементов одного типа, XmlDataSource Экземпляр следует рассматривать так же, как если бы он был aDataTable пример. В противном случаеXmlDataSource экземпляр должен быть обработан так же, как если бы он былDataRowпример. Для получения дополнительной информации см. справочник по синтаксису шаблона (https://docs.groupdocs.com/display/assemblynet/Template+Syntax+-+Part+1+of+2#TemplateSyntax-Part1of2-UsingDataSources).

Когда определение схемы XML передается конструктору этого класса, типы данных значений простых элементов XML и атрибутов определяются в соответствии со схемой. Таким образом, в документах-шаблонах вы можете работать с типизированными значениями , а не только со строками.

Когда определение XML-схемы не передается конструктору этого класса, типы данных значений простых элементов XML и атрибутов определяются автоматически на основе их строковых представлений. Таким образом, в шаблонных документах вы можете работать с типизированными значениями и в этом случае. Движок способен автоматически распознавать значения следующих типов:

  • Nullable
  • Nullable
  • Nullable
  • Nullable
  • String

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

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

Смотрите также