XmlDataDocument.Load Methode

Definitie

Laadt het XmlDataDocument gebruik van de opgegeven gegevensbron en synchroniseert de DataSet met de geladen gegevens.

Overloads

Name Description
Load(Stream)

Laadt de XmlDataDocument stroom van de opgegeven stroom.

Load(TextReader)

Laadt de XmlDataDocument van de opgegeven TextReader.

Load(String)

Laadt het XmlDataDocument gebruik van de opgegeven URL.

Load(XmlReader)

Laadt de XmlDataDocument van de opgegeven XmlReader.

Opmerkingen

Note

Als u de XML-gegevens relationeel wilt weergeven, moet u eerst een schema opgeven dat moet worden gebruikt voor gegevenstoewijzing. U kunt dit doen door de ReadXmlSchema methode aan te roepen of door de tabellen en kolommen handmatig te DataSet maken. Deze stap moet worden uitgevoerd voordat u aanroept Load.

XmlDataDocument biedt geen ondersteuning voor het maken van entiteitsverwijzingen. Als de gegevens entiteitsverwijzingen bevatten, Load worden alle entiteitsverwijzingen omgezet en uitgebreid. Als u echter de Load overbelasting gebruikt die een XmlReader argument gebruikt, moet u een XmlReader opgeven waarmee entiteiten kunnen worden omgezet.

Load(Stream)

Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs

Laadt de XmlDataDocument stroom van de opgegeven stroom.

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)

Parameters

inStream
Stream

De stroom met het XML-document dat moet worden geladen.

Opmerkingen

XmlDataDocument biedt geen ondersteuning voor het maken van entiteitsverwijzingen. Als de gegevens entiteitsverwijzingen bevatten, Load worden alle entiteitsverwijzingen omgezet en uitgebreid.

Note

Als u de XML-gegevens relationeel wilt weergeven, moet u eerst een schema opgeven dat moet worden gebruikt voor gegevenstoewijzing. U kunt dit doen door de ReadXmlSchema methode aan te roepen of door de tabellen en kolommen handmatig te DataSet maken. Deze stap moet worden uitgevoerd voordat u aanroept Load.

Van toepassing op

Load(TextReader)

Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs

Laadt de XmlDataDocument van de opgegeven 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)

Parameters

txtReader
TextReader

De TextReader gebruikte om de XML-gegevens in het document in te voeren.

Opmerkingen

XmlDataDocument biedt geen ondersteuning voor het maken van entiteitsverwijzingen. Als de gegevens entiteitsverwijzingen bevatten, Load worden alle entiteitsverwijzingen omgezet en uitgebreid.

Note

Als u de XML-gegevens relationeel wilt weergeven, moet u eerst een schema opgeven dat moet worden gebruikt voor gegevenstoewijzing. U kunt dit doen door de ReadXmlSchema methode aan te roepen of door de tabellen en kolommen handmatig te DataSet maken. Deze stap moet worden uitgevoerd voordat u aanroept Load.

Van toepassing op

Load(String)

Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs

Laadt het XmlDataDocument gebruik van de opgegeven 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)

Parameters

filename
String

De URL van het bestand met het XML-document dat moet worden geladen.

Opmerkingen

XmlDataDocument biedt geen ondersteuning voor het maken van entiteitsverwijzingen. Als de gegevens entiteitsverwijzingen bevatten, Load worden alle entiteitsverwijzingen omgezet en uitgebreid.

Note

Als u de XML-gegevens relationeel wilt weergeven, moet u eerst een schema opgeven dat moet worden gebruikt voor gegevenstoewijzing. U kunt dit doen door de ReadXmlSchema methode aan te roepen of door de tabellen en kolommen handmatig te DataSet maken. Deze stap moet worden uitgevoerd voordat u aanroept Load.

Van toepassing op

Load(XmlReader)

Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs
Bron:
XmlDataDocument.cs

Laadt de XmlDataDocument van de opgegeven 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)

Parameters

reader
XmlReader

Het XmlReader bestand dat het XML-document bevat dat moet worden geladen.

Uitzonderingen

De XML die wordt geladen, bevat entiteitsverwijzingen en de lezer kan entiteiten niet oplossen.

Opmerkingen

XmlDataDocument biedt geen ondersteuning voor het maken van entiteitsverwijzingen. Als de gegevensbron entiteitsverwijzingen bevat, moet u een XmlValidatingReader eigenschap maken die EntityHandling is ingesteld op EntityHandling.ExpandEntities (dit is het standaardgedrag) en de XmlValidatingReader methode doorgeven aan de Load methode. Als u geen XmlValidatingReaderuitzondering gebruikt, genereert de Load methode een uitzondering.

De Load methode behoudt altijd aanzienlijke witruimte. De PreserveWhitespace eigenschap bepaalt of witruimte al dan niet behouden blijft. De standaardwaarde is false, witruimte blijft niet behouden.

Als de lezer de oorspronkelijke status heeft (dat wil gezegd: ReadState=ReadState.Initial), Load wordt de volledige inhoud van de lezer gebruikt en wordt de DOM gebouwd op basis van wat de lezer vindt.

Als de lezer al op een bepaald knooppunt op diepte 'n' staat, wordt dat knooppunt en alle volgende knooppunten geladen tot aan de eindtag die diepte n sluit. Dit heeft de volgende resultaten.

Als het huidige knooppunt en de volgende knooppunten er ongeveer als volgt uitzien:

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

Load genereert een uitzondering, omdat een document geen twee elementen op hoofdniveau kan bevatten. Als het huidige knooppunt en de volgende knooppunten er ongeveer als volgt uitzien:

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

Load zal slagen; U hebt echter een onvolledige DOM-structuur, omdat er geen element op hoofdniveau is. U moet een element op hoofdniveau toevoegen voordat u het document opslaat; anders genereert de Save methode een uitzondering.

Als de lezer zich bevindt op een bladknooppunt dat ongeldig is voor het wortelniveau van een document (bijvoorbeeld een witruimte of kenmerkknooppunt), blijft de lezer het document lezen totdat deze zich bevindt op een knooppunt dat kan worden gebruikt voor het wortelknooppunt. Het document wordt nu geladen.

Van toepassing op