XmlDataDocument.Load Metod

Definition

Namnområde:: System.Xml

Sammansättning:: System.Data.Common.dll

Sammansättning:: System.Data.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

XmlDataDocument Läser in med den angivna datakällan och synkroniserar DataSet med inlästa data.

Överlagringar

Name	Description
Load(Stream)	`XmlDataDocument` Läser in från den angivna strömmen.
Load(TextReader)	`XmlDataDocument` Läser in från den angivna TextReader.
Load(String)	`XmlDataDocument` Läser in med den angivna URL:en.
Load(XmlReader)	`XmlDataDocument` Läser in från den angivna XmlReader.

Kommentarer

Note

För att kunna visa XML-data relationellt måste du först ange ett schema som ska användas för datamappning. Detta kan göras antingen genom att anropa ReadXmlSchema metoden eller genom att skapa tabellerna och kolumnerna DataSet i manuellt. Det här steget måste göras innan du anropar Load.

XmlDataDocument stöder inte att skapa entitetsreferenser. Om data innehåller entitetsreferenser Load löser och expanderar metoden alla entitetsreferenser. Men om du använder överbelastningen Load som tar ett XmlReader argument måste du ange en XmlReader som kan matcha entiteter.

Load(Stream)

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

XmlDataDocument Läser in från den angivna strömmen.

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)

Parametrar

inStream: Stream

Strömmen som innehåller XML-dokumentet som ska läsas in.

Kommentarer

XmlDataDocument stöder inte att skapa entitetsreferenser. Om data innehåller entitetsreferenser Load löser och expanderar metoden alla entitetsreferenser.

Note

Gäller för

Load(TextReader)

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

XmlDataDocument Läser in från den angivna 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)

Parametrar

txtReader: TextReader

Används TextReader för att mata in XML-data i dokumentet.

Kommentarer

XmlDataDocument stöder inte att skapa entitetsreferenser. Om data innehåller entitetsreferenser Load löser och expanderar metoden alla entitetsreferenser.

Note

Gäller för

Load(String)

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

XmlDataDocument Läser in med den angivna URL:en.

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)

Parametrar

filename: String

URL:en för filen som innehåller XML-dokumentet som ska läsas in.

Kommentarer

XmlDataDocument stöder inte att skapa entitetsreferenser. Om data innehåller entitetsreferenser Load löser och expanderar metoden alla entitetsreferenser.

Note

Gäller för

Load(XmlReader)

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

Källa:: XmlDataDocument.cs

XmlDataDocument Läser in från den angivna 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)

Parametrar

reader: XmlReader

Innehåller XmlReader XML-dokumentet som ska läsas in.

Undantag

NotSupportedException

XML-koden som läses in innehåller entitetsreferenser och läsaren kan inte matcha entiteter.

Kommentarer

XmlDataDocument stöder inte att skapa entitetsreferenser. Om datakällan innehåller entitetsreferenser måste du skapa en XmlValidatingReader med EntityHandling egenskapen inställd på EntityHandling.ExpandEntiteter (detta är standardbeteendet) och skicka XmlValidatingReader till Load -metoden. Om du inte använder en XmlValidatingReaderLoad genererar metoden ett undantag.

Metoden Load bevarar alltid betydande blanksteg. Egenskapen PreserveWhitespace avgör om tomt utrymme bevaras eller inte. Standardvärdet är false, tomt utrymme bevaras inte.

Om läsaren är i det ursprungliga tillståndet (det vill säga ReadState=ReadState.Initial) Load förbrukar hela innehållet i läsaren och skapar DOM från vad den hittar.

Om läsaren redan är placerad på någon nod på djupet "n" läser den här metoden in noden och alla efterföljande syskon upp till sluttaggen som stänger djupet "n". Detta har följande resultat.

Om den aktuella noden och dess följande syskon ser ut ungefär så här:

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

Load genererar ett undantag eftersom ett dokument inte kan ha två element på rotnivå. Om den aktuella noden och dess följande syskon ser ut ungefär så här:

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

Load kommer att lyckas. Du kommer dock att ha ett ofullständigt DOM-träd eftersom det inte finns något element på rotnivå. Du måste lägga till ett element på rotnivå innan du sparar dokumentet. annars Save utlöser metoden ett undantag.

Om läsaren är placerad på en lövnod som är ogiltig för rotnivån i ett dokument (till exempel ett tomt utrymme eller en attributnod) fortsätter läsaren att läsa tills den är placerad på en nod som kan användas för roten. Dokumentet börjar läsas in nu.

Gäller för

Feedback

Var den här sidan till hjälp?