XmlDataSource

XmlDataSource class

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

Чтобы узнать больше, посетитеМеханизм отчетов LINQ документальная статья.

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-данных.

Примечания

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

В шаблонных документах, если элемент XML верхнего уровня содержит только список элементов одного типа, XmlDataSource экземпляр следует обрабатывать так же, как если бы это был DataTable экземпляр. В противном случае,XmlDataSource экземпляр следует обрабатывать так же, как если бы это был DataRow Экземпляр . Для получения дополнительной информации см. справочник по синтаксису шаблонов (https://docs.aspose.com/display/wordsnet/Template+Syntax).

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

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

  • Nullable
  • Nullable
  • Nullable
  • Nullable
  • String

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

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

Примеры

Покажите, как использовать XML в качестве источника данных (строки).

Document doc = new Document(MyDir + "Reporting engine template - XML data destination.docx");

XmlDataSource dataSource = new XmlDataSource(MyDir + "List of people.xml");
BuildReport(doc, dataSource, "persons");

doc.Save(ArtifactsDir + "ReportingEngine.XmlDataString.docx");

Покажите, как использовать XML в качестве источника данных (потока).

Document doc = new Document(MyDir + "Reporting engine template - XML data destination.docx");

using (FileStream stream = File.OpenRead(MyDir + "List of people.xml"))
{
    XmlDataSource dataSource = new XmlDataSource(stream);
    BuildReport(doc, dataSource, "persons");
}

doc.Save(ArtifactsDir + "ReportingEngine.XmlDataStream.docx");

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

XmlDataLoadOptions Class