XmlDataDocument.Load Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Data.Common.dll

XmlDataDocument Načte pomocí zadaného zdroje dat a synchronizuje se načtenými datyDataSet.

Přetížení

Name	Description
Load(Stream)	Načte XmlDataDocument ze zadaného datového proudu.
Load(TextReader)	Načte ze zadaného TextReaderobjektu XmlDataDocument .
Load(String)	Načte zadanou XmlDataDocument adresu URL.
Load(XmlReader)	Načte ze zadaného XmlReaderobjektu XmlDataDocument .

Poznámky

Poznámka:

Chcete-li zobrazit data XML relační, musíte nejprve zadat schéma, které se má použít pro mapování dat. Můžete to provést buď voláním ReadXmlSchema metody, nebo vytvořením tabulek a sloupců v rámci DataSet ručně. Tento krok musí být proveden před voláním Load.

XmlDataDocument nepodporuje vytváření odkazů na entity. Pokud data obsahují odkazy na entity, Load metoda přeloží a rozbalí všechny odkazy na entity. Pokud však používáte Load přetížení, které přebírá XmlReader jako argument, musíte zadat entitu XmlReader , která dokáže přeložit entity.

Load(Stream)

Zdroj:

XmlDataDocument.cs

Načte XmlDataDocument ze zadaného datového proudu.

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)

Parametry

inStream

Stream

Datový proud obsahující dokument XML, který se má načíst.

Poznámky

XmlDataDocument nepodporuje vytváření odkazů na entity. Pokud data obsahují odkazy na entity, Load metoda přeloží a rozbalí všechny odkazy na entity.

Poznámka:

Chcete-li zobrazit data XML relační, musíte nejprve zadat schéma, které se má použít pro mapování dat. Můžete to provést buď voláním ReadXmlSchema metody, nebo vytvořením tabulek a sloupců v rámci DataSet ručně. Tento krok musí být proveden před voláním Load.

Load(TextReader)

Zdroj:

XmlDataDocument.cs

Načte ze zadaného TextReaderobjektu XmlDataDocument .

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)

Parametry

txtReader

TextReader

Slouží TextReader k podávání dat XML do dokumentu.

Poznámky

XmlDataDocument nepodporuje vytváření odkazů na entity. Pokud data obsahují odkazy na entity, Load metoda přeloží a rozbalí všechny odkazy na entity.

Poznámka:

Chcete-li zobrazit data XML relační, musíte nejprve zadat schéma, které se má použít pro mapování dat. Můžete to provést buď voláním ReadXmlSchema metody, nebo vytvořením tabulek a sloupců v rámci DataSet ručně. Tento krok musí být proveden před voláním Load.

Load(String)

Zdroj:

XmlDataDocument.cs

Načte zadanou XmlDataDocument adresu URL.

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)

Parametry

filename

String

Adresa URL souboru obsahujícího dokument XML, který se má načíst.

Poznámky

XmlDataDocument nepodporuje vytváření odkazů na entity. Pokud data obsahují odkazy na entity, Load metoda přeloží a rozbalí všechny odkazy na entity.

Poznámka:

Chcete-li zobrazit data XML relační, musíte nejprve zadat schéma, které se má použít pro mapování dat. Můžete to provést buď voláním ReadXmlSchema metody, nebo vytvořením tabulek a sloupců v rámci DataSet ručně. Tento krok musí být proveden před voláním Load.

Load(XmlReader)

Zdroj:

XmlDataDocument.cs

Načte ze zadaného XmlReaderobjektu XmlDataDocument .

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)

Parametry

reader

XmlReader

Obsahující XmlReader dokument XML, který se má načíst.

Výjimky

NotSupportedException

Načtený KÓD XML obsahuje odkazy na entity a čtenář nemůže přeložit entity.

Poznámky

XmlDataDocument nepodporuje vytváření odkazů na entity. Pokud zdroj dat obsahuje odkazy na entity, musíte vytvořit XmlValidatingReader s EntityHandling vlastností nastavenou na EntityHandling.ExpandEntities (toto je výchozí chování) a předat XmlValidatingReader metodě Load . Pokud nepoužíváte XmlValidatingReader, Load vyvolá metoda výjimku.

Metoda Load vždy zachovává významné prázdné znaky. Vlastnost PreserveWhitespace určuje, zda je zachováno prázdné znaky. Výchozí hodnota je false, prázdné znaky se nezachovají.

Pokud je čtenář v počátečním stavu (tj. ReadState=ReadState.Initial), Load využívá celý obsah čtečky a sestaví dom z toho, co najde.

Pokud je čtenář již umístěn na určitém uzlu v hloubkové "n", pak tato metoda načte tento uzel a všechny následné na stejné úrovni až do koncové značky, která zavře hloubku "n". To má následující výsledky.

Pokud aktuální uzel a jeho následující na stejné úrovni vypadají podobně jako následující:

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

Load vyvolá výjimku, protože dokument nemůže mít dva elementy kořenové úrovně. Pokud aktuální uzel a jeho následující na stejné úrovni vypadají podobně jako následující:

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

Load bude úspěšná; Ale budete mít neúplný strom DOM, protože neexistuje žádný prvek kořenové úrovně. Před uložením dokumentu musíte přidat prvek kořenové úrovně; v opačném případě metoda Save vyvolá výjimku.

Pokud je čtečka umístěna na uzlu typu list, který je neplatný pro kořenovou úroveň dokumentu (například prázdný znak nebo uzel atributu), bude čtečka dál číst, dokud nebude umístěna na uzlu, který lze použít pro kořen. Dokument se v tomto okamžiku začne načítat.