XmlDataDocument.Load Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Data.Common.dll

XmlDataDocument Ładuje przy użyciu określonego źródła danych i synchronizuje DataSet dane załadowane.

Przeciążenia

Nazwa	Opis
Load(Stream)	Ładuje element XmlDataDocument z określonego strumienia.
Load(TextReader)	Ładuje element XmlDataDocument z określonego TextReaderelementu .
Load(String)	XmlDataDocument Ładuje przy użyciu określonego adresu URL.
Load(XmlReader)	Ładuje element XmlDataDocument z określonego XmlReaderelementu .

Uwagi

Uwaga / Notatka

Aby wyświetlić dane XML relacyjne, należy najpierw określić schemat do użycia na potrzeby mapowania danych. Można to zrobić, wywołując metodę ReadXmlSchema lub tworząc tabele i kolumny w obrębie DataSet ręcznie. Ten krok należy wykonać przed wywołaniem metody Load.

XmlDataDocument nie obsługuje tworzenia odwołań do jednostek. Jeśli dane zawierają odwołania do jednostki, Load metoda rozpozna i rozszerzy wszystkie odwołania do jednostek. Jeśli jednak używasz przeciążenia, które przyjmuje LoadXmlReader jako argument, musisz określić XmlReader , który może rozpoznać jednostki.

Load(Stream)

Źródło:

XmlDataDocument.cs

Ładuje element XmlDataDocument z określonego strumienia.

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

Strumień zawierający dokument XML do załadowania.

Uwagi

XmlDataDocument nie obsługuje tworzenia odwołań do jednostek. Jeśli dane zawierają odwołania do jednostki, Load metoda rozpozna i rozszerzy wszystkie odwołania do jednostek.

Uwaga / Notatka

Aby wyświetlić dane XML relacyjne, należy najpierw określić schemat do użycia na potrzeby mapowania danych. Można to zrobić, wywołując metodę ReadXmlSchema lub tworząc tabele i kolumny w obrębie DataSet ręcznie. Ten krok należy wykonać przed wywołaniem metody Load.

Load(TextReader)

Źródło:

XmlDataDocument.cs

Ładuje element XmlDataDocument z określonego TextReaderelementu .

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

Element TextReader używany do podawania danych XML do dokumentu.

Uwagi

XmlDataDocument nie obsługuje tworzenia odwołań do jednostek. Jeśli dane zawierają odwołania do jednostki, Load metoda rozpozna i rozszerzy wszystkie odwołania do jednostek.

Uwaga / Notatka

Aby wyświetlić dane XML relacyjne, należy najpierw określić schemat do użycia na potrzeby mapowania danych. Można to zrobić, wywołując metodę ReadXmlSchema lub tworząc tabele i kolumny w obrębie DataSet ręcznie. Ten krok należy wykonać przed wywołaniem metody Load.

Load(String)

Źródło:

XmlDataDocument.cs

XmlDataDocument Ładuje przy użyciu określonego 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

Adres URL pliku zawierającego dokument XML do załadowania.

Uwagi

XmlDataDocument nie obsługuje tworzenia odwołań do jednostek. Jeśli dane zawierają odwołania do jednostki, Load metoda rozpozna i rozszerzy wszystkie odwołania do jednostek.

Uwaga / Notatka

Aby wyświetlić dane XML relacyjne, należy najpierw określić schemat do użycia na potrzeby mapowania danych. Można to zrobić, wywołując metodę ReadXmlSchema lub tworząc tabele i kolumny w obrębie DataSet ręcznie. Ten krok należy wykonać przed wywołaniem metody Load.

Load(XmlReader)

Źródło:

XmlDataDocument.cs

Ładuje element XmlDataDocument z określonego XmlReaderelementu .

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

Plik XmlReader zawierający dokument XML do załadowania.

Wyjątki

NotSupportedException

Ładowany kod XML zawiera odwołania do jednostek, a czytelnik nie może rozpoznać jednostek.

Uwagi

XmlDataDocument nie obsługuje tworzenia odwołań do jednostek. Jeśli źródło danych zawiera odwołania do jednostki, należy utworzyć obiekt XmlValidatingReader z właściwością EntityHandling ustawioną na EntityHandling.ExpandEntities (jest to zachowanie domyślne) i przekazać element XmlValidatingReader do Load metody . Jeśli nie używasz XmlValidatingReadermetody , Load metoda zgłasza wyjątek.

Metoda Load zawsze zachowuje znaczne odstępy. Właściwość PreserveWhitespace określa, czy odstęp jest zachowywany. Wartość domyślna to false, biały znak nie jest zachowywany.

Jeśli czytelnik jest w stanie początkowym (czyli ReadState=ReadState.Initial), Load zużywa całą zawartość czytnika i tworzy dom z tego, co znajdzie.

Jeśli czytnik jest już umieszczony w niektórych węzłach na głębokości "n", ta metoda ładuje ten węzeł i wszystkie kolejne elementy równorzędne do tagu końcowego, który zamyka głębokość "n". Ma to następujące wyniki.

Jeśli bieżący węzeł i jego następujące elementy równorzędne wyglądają podobnie do następujących:

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

Load zgłasza wyjątek, ponieważ dokument nie może mieć dwóch elementów na poziomie głównym. Jeśli bieżący węzeł i jego następujące elementy równorzędne wyglądają podobnie do następujących:

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

Load zakończy się powodzeniem; jednak będziesz mieć niekompletne drzewo DOM, ponieważ nie ma elementu na poziomie głównym. Przed zapisaniem dokumentu musisz dodać element poziomu głównego; Save w przeciwnym razie metoda zgłasza wyjątek.

Jeśli czytelnik jest umieszczony w węźle liścia, który jest nieprawidłowy dla poziomu głównego dokumentu (na przykład spacja lub węzeł atrybutu), będzie kontynuował odczytywanie, dopóki nie zostanie umieszczony w węźle, który może być używany dla poziomu głównego. Dokument rozpoczyna ładowanie w tym momencie.