XmlDataDocument.Load Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Data.Common.dll

Charge l’utilisation XmlDataDocument de la source de données spécifiée et synchronise les DataSet données chargées.

Surcharges

Nom	Description
Load(Stream)	Charge le XmlDataDocument flux spécifié.
Load(TextReader)	Charge le fichier XmlDataDocument à partir de l’objet spécifié TextReader.
Load(String)	Charge l’url spécifiée à l’aide XmlDataDocument de l’URL spécifiée.
Load(XmlReader)	Charge le fichier XmlDataDocument à partir de l’objet spécifié XmlReader.

Remarques

Note

Pour afficher les données XML relationnellement, vous devez d’abord spécifier un schéma à utiliser pour le mappage de données. Pour ce faire, appelez la ReadXmlSchema méthode ou créez les tables et colonnes manuellement DataSet . Cette étape doit être effectuée avant d’appeler Load.

XmlDataDocument ne prend pas en charge la création de références d’entité. Si les données incluent des références d’entité, la Load méthode résout et développe toutes les références d’entité. Toutefois, si vous utilisez la Load surcharge qui prend un XmlReader argument, vous devez spécifier une XmlReader entité capable de résoudre les entités.

Load(Stream)

Source:

XmlDataDocument.cs

Charge le XmlDataDocument flux spécifié.

public:
 override void Load(System::IO::Stream ^ inStream);

public override void Load(System.IO.Stream inStream);

override this.Load : System.IO.Stream -> unit

Public Overrides Sub Load (inStream As Stream)

Paramètres

inStream

Stream

Flux contenant le document XML à charger.

Remarques

XmlDataDocument ne prend pas en charge la création de références d’entité. Si les données incluent des références d’entité, la Load méthode résout et développe toutes les références d’entité.

Note

Pour afficher les données XML relationnellement, vous devez d’abord spécifier un schéma à utiliser pour le mappage de données. Pour ce faire, appelez la ReadXmlSchema méthode ou créez les tables et colonnes manuellement DataSet . Cette étape doit être effectuée avant d’appeler Load.

Load(TextReader)

Source:

XmlDataDocument.cs

Charge le fichier XmlDataDocument à partir de l’objet spécifié TextReader.

public:
 override void Load(System::IO::TextReader ^ txtReader);

public override void Load(System.IO.TextReader txtReader);

override this.Load : System.IO.TextReader -> unit

Public Overrides Sub Load (txtReader As TextReader)

Paramètres

txtReader

TextReader

TextReader Utilisé pour alimenter les données XML dans le document.

Remarques

XmlDataDocument ne prend pas en charge la création de références d’entité. Si les données incluent des références d’entité, la Load méthode résout et développe toutes les références d’entité.

Note

Pour afficher les données XML relationnellement, vous devez d’abord spécifier un schéma à utiliser pour le mappage de données. Pour ce faire, appelez la ReadXmlSchema méthode ou créez les tables et colonnes manuellement DataSet . Cette étape doit être effectuée avant d’appeler Load.

Load(String)

Source:

XmlDataDocument.cs

Charge l’url spécifiée à l’aide XmlDataDocument de l’URL spécifiée.

public:
 override void Load(System::String ^ filename);

public override void Load(string filename);

override this.Load : string -> unit

Public Overrides Sub Load (filename As String)

Paramètres

filename

String

URL du fichier contenant le document XML à charger.

Remarques

XmlDataDocument ne prend pas en charge la création de références d’entité. Si les données incluent des références d’entité, la Load méthode résout et développe toutes les références d’entité.

Note

Pour afficher les données XML relationnellement, vous devez d’abord spécifier un schéma à utiliser pour le mappage de données. Pour ce faire, appelez la ReadXmlSchema méthode ou créez les tables et colonnes manuellement DataSet . Cette étape doit être effectuée avant d’appeler Load.

Load(XmlReader)

Source:

XmlDataDocument.cs

Charge le fichier XmlDataDocument à partir de l’objet spécifié XmlReader.

public:
 override void Load(System::Xml::XmlReader ^ reader);

public override void Load(System.Xml.XmlReader reader);

override this.Load : System.Xml.XmlReader -> unit

Public Overrides Sub Load (reader As XmlReader)

Paramètres

reader

XmlReader

Contenant XmlReader le document XML à charger.

Exceptions

NotSupportedException

Le code XML chargé contient des références d’entité et le lecteur ne peut pas résoudre les entités.

Remarques

XmlDataDocument ne prend pas en charge la création de références d’entité. Si la source de données contient des références d’entité, vous devez créer une XmlValidatingReader propriété définie EntityHandling sur EntityHandling.ExpandEntities (il s’agit du comportement par défaut) et transmettre la XmlValidatingReaderLoad méthode. Si vous n’utilisez pas d’exception XmlValidatingReader, la Load méthode lève une exception.

La Load méthode conserve toujours un espace blanc significatif. La PreserveWhitespace propriété détermine si l’espace blanc est conservé ou non. La valeur par défaut est false, l’espace blanc n’est pas conservé.

Si le lecteur est dans l’état initial (autrement dit, ReadState=ReadState.Initial), Load consomme l’intégralité du contenu du lecteur et génère le DOM à partir de ce qu’il trouve.

Si le lecteur est déjà positionné sur un nœud à la profondeur « n », cette méthode charge ce nœud et tous les frères suivants jusqu’à la balise de fin qui ferme la profondeur « n ». Cela a les résultats suivants.

Si le nœud actuel et ses frères suivants ressemblent à ce qui suit :

<!--comment--><element1>one</element1><element2>two</element2>

Load lève une exception, car un document ne peut pas avoir deux éléments de niveau racine. Si le nœud actuel et ses frères suivants ressemblent à ce qui suit :

<!--comment--><?process
    instruction?><!--comment--></endtag>

Load réussira ; Toutefois, vous disposez d’une arborescence DOM incomplète, car il n’existe aucun élément de niveau racine. Vous devez ajouter un élément de niveau racine avant d’enregistrer le document ; sinon, la Save méthode lève une exception.

Si le lecteur est positionné sur un nœud feuille non valide pour le niveau racine d’un document (par exemple, un espace blanc ou un nœud d’attribut), le lecteur continue de lire jusqu’à ce qu’il soit positionné sur un nœud qui peut être utilisé pour la racine. Le document commence à se charger à ce stade.