XmlDataSource

XmlDataSource class

Fournit un accès aux données d’un fichier XML ou d’un flux à utiliser lors de l’assemblage d’un document.

public class XmlDataSource

Constructeurs

Nom La description
XmlDataSource(Stream) Crée une nouvelle source de données avec les données d’un flux XML à l’aide des options par défaut pour le chargement des données XML.
XmlDataSource(string) Crée une nouvelle source de données avec les données d’un fichier XML en utilisant les options par défaut pour le chargement des données XML.
XmlDataSource(Stream, Stream) Crée une nouvelle source de données avec des données provenant d’un flux XML à l’aide d’un flux XML Schema Definition. Les options par défaut sont utilisées pour le chargement des données XML.
XmlDataSource(Stream, XmlDataLoadOptions) Crée une nouvelle source de données avec les données d’un flux XML à l’aide des options spécifiées pour le chargement des données XML.
XmlDataSource(string, string) Crée une nouvelle source de données avec les données d’un fichier XML à l’aide d’un fichier de définition de schéma XML. Les options par défaut sont utilisées pour le chargement des données XML.
XmlDataSource(string, XmlDataLoadOptions) Crée une nouvelle source de données avec les données d’un fichier XML à l’aide des options spécifiées pour le chargement des données XML.
XmlDataSource(Stream, Stream, XmlDataLoadOptions) Crée une nouvelle source de données avec des données provenant d’un flux XML à l’aide d’un flux XML Schema Definition. Les options spécifiées sont utilisées pour le chargement des données XML.
XmlDataSource(string, string, XmlDataLoadOptions) Crée une nouvelle source de données avec les données d’un fichier XML à l’aide d’un fichier de définition de schéma XML. Les options spécifiées sont utilisées pour le chargement des données XML.

Remarques

Pour accéder aux données du fichier ou du flux correspondant lors de l’assemblage d’un document, passez une instance de cette classe en tant que une source de données à l’un desDocumentAssembler .AssembleDocument surcharges.

Dans les modèles de documents, si un élément XML de niveau supérieur ne contient qu’une liste d’éléments du même type, unXmlDataSource instance doit être traitée de la même manière que si elle était aDataTable exemple. Sinon, unXmlDataSource instance doit être traitée de la même manière que s’il s’agissait d’unDataRowexemple. Pour plus d’informations, consultez la référence de syntaxe du modèle (https://docs.groupdocs.com/display/assemblynet/Template+Syntax+-+Part+1+of+2#TemplateSyntax-Part1of2-UsingDataSources).

Lorsque la définition de schéma XML est transmise à un constructeur de cette classe, les types de données des valeurs des éléments XML simples et des attributs sont déterminés en fonction du schéma. Ainsi, dans les modèles de documents, vous pouvez travailler avec des valeurs typées plutôt qu’avec des chaînes.

Lorsque la définition de schéma XML n’est pas transmise à un constructeur de cette classe, les types de données des valeurs des éléments XML simples et des attributs sont déterminés automatiquement en fonction de leurs représentations sous forme de chaîne. Ainsi, dans les modèles de documents, vous pouvez également utiliser avec des valeurs typées dans ce cas. Le moteur est capable de reconnaître automatiquement les valeurs des types suivants :

  • Nullable
  • Nullable
  • Nullable
  • Nullable
  • String

Notez que pour que la reconnaissance automatique des types de données fonctionne, les représentations sous forme de chaîne des valeurs des éléments XML simples et des attributs doivent être formées à l’aide de paramètres de culture invariants.

Pour remplacer le comportement par défaut du chargement des données XML, initialisez et transmettez unXmlDataLoadOptions instance à un constructeur de cette classe.

Voir également