XmlReader.Create Methode

Definitie

Naamruimte:: System.Xml

Assembly's:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Assembly's:: System.Xml.dll, System.Xml.ReaderWriter.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee maakt u een nieuw XmlReader-exemplaar.

Overloads

Name	Description
Create(String, XmlReaderSettings, XmlParserContext)	Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven URI, instellingen en contextinformatie voor parseren.
Create(TextReader, XmlReaderSettings, XmlParserContext)	Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven tekstlezer, instellingen en contextinformatie voor parseren.
Create(Stream, XmlReaderSettings, XmlParserContext)	Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven stroom, instellingen en contextinformatie voor parseren.
Create(Stream, XmlReaderSettings, String)	Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven stream, basis-URI en instellingen.
Create(XmlReader, XmlReaderSettings)	Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven XML-lezer en -instellingen.
Create(TextReader, XmlReaderSettings, String)	Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven tekstlezer, instellingen en basis-URI.
Create(TextReader, XmlReaderSettings)	Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven tekstlezer en -instellingen.
Create(Stream, XmlReaderSettings)	Hiermee maakt u een nieuw XmlReader exemplaar met de opgegeven stream en instellingen.
Create(String)	Hiermee maakt u een nieuw XmlReader exemplaar met de opgegeven URI.
Create(TextReader)	Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven tekstlezer.
Create(Stream)	Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven stream met standaardinstellingen.
Create(String, XmlReaderSettings)	Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven URI en instellingen.

Voorbeelden

In dit voorbeeld wordt een XML-lezer gemaakt die onbeduidende witruimte verwijdert, opmerkingen verwijdert en nalevingscontrole op fragmentniveau uitvoert.

XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.IgnoreWhitespace = true;
settings.IgnoreComments = true;
XmlReader reader = XmlReader.Create("books.xml", settings);

Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.IgnoreWhitespace = true
settings.IgnoreComments = true
Dim reader As XmlReader = XmlReader.Create("books.xml", settings)

In het volgende voorbeeld wordt een XmlUrlResolver met standaardreferenties gebruikt om toegang te krijgen tot een bestand.

// Set the reader settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.IgnoreComments = true;
settings.IgnoreProcessingInstructions = true;
settings.IgnoreWhitespace = true;

' Set the reader settings.
Dim settings as XmlReaderSettings = new XmlReaderSettings()
settings.IgnoreComments = true
settings.IgnoreProcessingInstructions = true
settings.IgnoreWhitespace = true

// Create a resolver with default credentials.
XmlUrlResolver resolver = new XmlUrlResolver();
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials;

// Set the reader settings object to use the resolver.
settings.XmlResolver = resolver;

// Create the XmlReader object.
XmlReader reader = XmlReader.Create("http://ServerName/data/books.xml", settings);

' Create a resolver with default credentials.
Dim resolver as XmlUrlResolver = new XmlUrlResolver()
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials

' Set the reader settings object to use the resolver.
settings.XmlResolver = resolver

' Create the XmlReader object.
Dim reader as XmlReader = XmlReader.Create("http://ServerName/data/books.xml", settings)

Met de volgende code wordt een lezerinstantie in een andere lezer verpakt.

XmlTextReader txtReader = new XmlTextReader("bookOrder.xml");
XmlReaderSettings settings = new XmlReaderSettings();
settings.Schemas.Add("urn:po-schema", "PO.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader reader = XmlReader.Create(txtReader, settings);

Dim txtReader As XmlTextReader = New XmlTextReader("bookOrder.xml")
Dim settings As New XmlReaderSettings()
settings.Schemas.Add("urn:po-schema", "PO.xsd")
settings.ValidationType = ValidationType.Schema
Dim reader As XmlReader = XmlReader.Create(txtReader, settings)

In dit voorbeeld worden lezers gedwongen om DTD- en XML-schemavalidatie toe te voegen.

XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.DTD;
XmlReader inner = XmlReader.Create("book.xml", settings); // DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader outer = XmlReader.Create(inner, settings);  // XML Schema Validation

Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.DTD
Dim inner As XmlReader = XmlReader.Create("book.xml", settings) ' DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd")
settings.ValidationType = ValidationType.Schema
Dim outer As XmlReader = XmlReader.Create(inner, settings)  ' XML Schema Validation

Opmerkingen

Create De meeste overbelastingen bevatten een settings parameter die een XmlReaderSettings object accepteert. U kunt dit object gebruiken voor het volgende:

Geef op welke functies u wilt ondersteunen voor het XmlReader object.
Gebruik het XmlReaderSettings object opnieuw om meerdere lezers te maken. U kunt dezelfde instellingen gebruiken om meerdere lezers met dezelfde functionaliteit te maken. U kunt ook de instellingen op een XmlReaderSettings exemplaar wijzigen en een nieuwe lezer maken met een andere set functies.
Voeg functies toe aan een bestaande XML-lezer. De Create methode kan een ander XmlReader object accepteren. Het onderliggende XmlReader object kan een door de gebruiker gedefinieerde lezer, een XmlTextReader object of een ander XmlReader exemplaar zijn waaraan u extra functies wilt toevoegen.
Profiteer optimaal van functies zoals betere nalevingscontrole en naleving van de aanbeveling xml 1.0 (vierde editie) die alleen beschikbaar zijn voor XmlReader objecten die door de statische Create methode zijn gemaakt.

Note

Hoewel .NET concrete implementaties van de XmlReader klasse bevat, zoals de XmlTextReader, XmlNodeReaderen de XmlValidatingReader klassen, raden we u aan om exemplaren te maken XmlReader met behulp van de Create methode.

Standaardinstellingen

Als u een Create overbelasting gebruikt die geen XmlReaderSettings object accepteert, worden de volgende standaardinstellingen voor lezer gebruikt:

Setting	Default
CheckCharacters	`true`
ConformanceLevel	ConformanceLevel.Document
IgnoreComments	`false`
IgnoreProcessingInstructions	`false`
IgnoreWhitespace	`false`
LineNumberOffset	0
LinePositionOffset	0
NameTable	`null`
DtdProcessing	Prohibit
Schemas	Een leeg XmlSchemaSet object
ValidationFlags	ProcessIdentityConstraints Ingeschakeld
ValidationType	None
XmlResolver	`null`

Instellingen voor algemene scenario's

Hier volgen de XmlReaderSettings eigenschappen die u moet instellen voor een aantal typische XML-lezerscenario's.

Requirement	Set
Gegevens moeten een goed opgemaakt XML-document zijn.	ConformanceLevel tot Document.
Gegevens moeten een goed opgemaakte XML-geparseerde entiteit zijn.	ConformanceLevel tot Fragment.
Gegevens moeten worden gevalideerd op basis van een DTD.	DtdProcessing tot en met Parse ValidationType tot DTD.
Gegevens moeten worden gevalideerd op basis van een XML-schema.	ValidationType tot en met Schema Schemas naar het XmlSchemaSet te gebruiken voor validatie. Houd er rekening mee dat XmlReader geen ondersteuning biedt voor Reduced XML-Data schemavalidatie (XDR).
Gegevens moeten worden gevalideerd op basis van een inline XML-schema.	ValidationType tot en met Schema ValidationFlags tot ProcessInlineSchema.
Typ ondersteuning.	ValidationType tot en met Schema SchemasnaarXmlSchemaSet te gebruiken.

XmlReader biedt geen ondersteuning voor XML-Data XDR-schemavalidatie (Reduced).

Asynchroon programmeren

In de synchrone modus leest de Create methode het eerste segment gegevens uit de buffer van het bestand, de stream of de tekstlezer. Dit kan een uitzondering veroorzaken als een I/O-bewerking mislukt. In de asynchrone modus vindt de eerste I/O-bewerking plaats met een leesbewerking, waardoor uitzonderingen optreden wanneer de leesbewerking plaatsvindt.

Beveiligingsoverwegingen

XmlReader Standaard wordt een XmlUrlResolver object zonder gebruikersreferenties gebruikt om resources te openen. Dit betekent dat de XML-lezer standaard toegang heeft tot elke locatie waarvoor geen referenties zijn vereist. Gebruik de XmlResolver eigenschap om toegang tot resources te beheren.

Gebruik ThrowingResolver dit om de resources te beperken waartoe de XML-lezer toegang heeft, of...
Stel XmlResolver in op null om te voorkomen dat de XML-lezer externe resources opent.

Create(String, XmlReaderSettings, XmlParserContext)

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven URI, instellingen en contextinformatie voor parseren.

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);

public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);

static member Create : string * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader

Public Shared Function Create (inputUri As String, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parameters

inputUri: String

De URI voor het bestand met de XML-gegevens. Het XmlResolver object op het XmlReaderSettings object wordt gebruikt om het pad te converteren naar een canonieke gegevensweergave. Als XmlResolver dat het is null, wordt een nieuw XmlUrlResolver object gebruikt.

settings: XmlReaderSettings

De instellingen voor het nieuwe XmlReader exemplaar. Deze waarde kan zijn null.

inputContext: XmlParserContext

De contextinformatie die nodig is om het XML-fragment te parseren. De contextinformatie kan het XmlNameTable te gebruiken, coderen, naamruimtebereik, het huidige xml:lang bereik en xml:space het bereik, de basis-URI en de definitie van het documenttype omvatten.

Deze waarde kan zijn null.

Retouren

XmlReader

Een object dat wordt gebruikt om de XML-gegevens in de stream te lezen.

Uitzonderingen

ArgumentNullException

De inputUri waarde is null.

SecurityException

De XmlReader machtiging beschikt niet over voldoende machtigingen voor toegang tot de locatie van de XML-gegevens.

ArgumentException

De NameTable en NameTable eigenschappen bevatten beide waarden. (Er kan slechts één van deze NameTable eigenschappen worden ingesteld en gebruikt).

FileNotFoundException

Het bestand dat is opgegeven door de URI, kan niet worden gevonden.

UriFormatException

De URI-indeling is niet juist.

Opmerkingen

Standaard wordt een XmlUrlResolver zonder referenties gebruikt voor toegang tot externe resources, zoals een definitie van een documenttype (DTD), entiteiten, schema's enzovoort.

Important

Vanaf het .NET Framework 4.5.2 wordt er geen standaard XmlUrlResolver geleverd. Als uw oplossing is gericht op de .NET Framework 4.5.2 of nieuwere versies, geeft u een XmlResolver op met behulp van de eigenschap XmlReaderSettings.XmlResolver.

Dit betekent dat de XmlReader toegang heeft tot alle locaties waarvoor geen verificatie is vereist. Als de externe resource zich op een netwerkresource bevindt waarvoor verificatie is vereist, gebruikt u de XmlReaderSettings.XmlResolver eigenschap om een XmlResolver met de benodigde referenties op te geven.

Important

U kunt de resources beperken waartoe ze XmlReader toegang hebben met behulp van ThrowingResolver.

Het gemaakte XmlReader object breidt entiteitsverwijzingen uit en voert XML-normalisatie van nieuwe regeltekens uit.

Van toepassing op

Create(TextReader, XmlReaderSettings, XmlParserContext)

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven tekstlezer, instellingen en contextinformatie voor parseren.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parameters

input: TextReader

De tekstlezer waaruit de XML-gegevens moeten worden gelezen. Een tekstlezer retourneert een stroom Unicode-tekens, dus de codering die is opgegeven in de XML-declaratie wordt niet gebruikt door de XML-lezer om de gegevensstroom te decoderen.

settings: XmlReaderSettings

De instellingen voor het nieuwe XmlReader exemplaar. Deze waarde kan zijn null.

inputContext: XmlParserContext

Deze waarde kan zijn null.

Retouren

XmlReader

Een object dat wordt gebruikt om de XML-gegevens in de stream te lezen.

Uitzonderingen

ArgumentNullException

De input waarde is null.

ArgumentException

De NameTable en NameTable eigenschappen bevatten beide waarden. (Er kan slechts één van deze NameTable eigenschappen worden ingesteld en gebruikt.)

Voorbeelden

In het volgende voorbeeld wordt een XmlReader object gemaakt waarmee een XML-fragment wordt gelezen.

string xmlFrag ="<item rk:ID='abc-23'>hammer</item> " +
                        "<item rk:ID='r2-435'>paint</item>" +
                        "<item rk:ID='abc-39'>saw</item>";

// Create the XmlNamespaceManager.
NameTable nt = new NameTable();
XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
nsmgr.AddNamespace("rk", "urn:store-items");

// Create the XmlParserContext.
XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.None);

// Create the reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
XmlReader reader = XmlReader.Create(new StringReader(xmlFrag), settings, context);

Dim xmlFrag As String = "<item rk:ID='abc-23'>hammer</item> " & _
                                     "<item rk:ID='r2-435'>paint</item>" & _
                                     "<item rk:ID='abc-39'>saw</item>"

' Create the XmlNamespaceManager.
Dim nt As New NameTable()
Dim nsmgr As New XmlNamespaceManager(nt)
nsmgr.AddNamespace("rk", "urn:store-items")

' Create the XmlParserContext.
Dim context As New XmlParserContext(Nothing, nsmgr, Nothing, XmlSpace.None)

' Create the reader. 
Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlFrag), settings, context)

Opmerkingen

Standaard wordt een XmlUrlResolver zonder referenties gebruikt voor toegang tot externe resources, zoals een definitie van een documenttype (DTD), entiteiten, schema's enzovoort.

Important

Als de externe resource zich op een netwerkresource bevindt waarvoor verificatie is vereist, gebruikt u de XmlReaderSettings.XmlResolver eigenschap om een XmlResolver met de benodigde referenties op te geven.

Important

U kunt een van de volgende methoden gebruiken om te bepalen welke resources toegankelijk XmlReader zijn:

Beperk de resources waartoe de XmlReader toegang is met behulp van ThrowingResolver.
Sta het niet toe dat XmlReader externe bronnen opent door de XmlResolver eigenschap in te stellen op null.

Het gemaakte XmlReader object breidt entiteitsverwijzingen uit en voert XML-normalisatie van nieuwe regeltekens uit.

Van toepassing op

Create(Stream, XmlReaderSettings, XmlParserContext)

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven stroom, instellingen en contextinformatie voor parseren.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader

Public Shared Function Create (input As Stream, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parameters

input: Stream

De stroom die de XML-gegevens bevat.

De XmlReader scant de eerste bytes van de stream op zoek naar een byteordermarkering of een ander teken van codering. Wanneer de codering wordt bepaald, wordt de codering gebruikt om de stroom verder te lezen en wordt de invoer verder geparseerd als een stroom (Unicode)-tekens.

settings: XmlReaderSettings

De instellingen voor het nieuwe XmlReader exemplaar. Deze waarde kan zijn null.

inputContext: XmlParserContext

Deze waarde kan zijn null.

Retouren

XmlReader

Een object dat wordt gebruikt om de XML-gegevens in de stream te lezen.

Uitzonderingen

ArgumentNullException

De input waarde is null.

Opmerkingen

Standaard wordt een XmlUrlResolver zonder referenties gebruikt voor toegang tot externe resources, zoals een definitie van een documenttype (DTD), entiteiten, schema's enzovoort.

Important

U kunt een van de volgende methoden gebruiken om te bepalen welke resources toegankelijk XmlReader zijn:

Beperk de resources waartoe de XmlReader toegang is met behulp van ThrowingResolver.
Sta het niet toe dat XmlReader externe bronnen opent door de XmlResolver eigenschap in te stellen op null.

Het gemaakte XmlReader object breidt entiteitsverwijzingen uit en voert XML-normalisatie van nieuwe regeltekens uit.

Van toepassing op

Create(Stream, XmlReaderSettings, String)

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven stream, basis-URI en instellingen.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings, System::String ^ baseUri);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings? settings, string? baseUri);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings settings, string baseUri);

static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader

Public Shared Function Create (input As Stream, settings As XmlReaderSettings, baseUri As String) As XmlReader

Parameters

input: Stream

De stroom die de XML-gegevens bevat.

settings: XmlReaderSettings

De instellingen voor het nieuwe XmlReader exemplaar. Deze waarde kan zijn null.

baseUri: String

De basis-URI voor de entiteit of het document die wordt gelezen. Deze waarde kan zijn null.

Beveiligingsnotitie De basis-URI wordt gebruikt om de relatieve URI van het XML-document op te lossen. Gebruik geen basis-URI van een niet-vertrouwde bron.

Retouren

XmlReader

Een object dat wordt gebruikt om de XML-gegevens in de stream te lezen.

Uitzonderingen

ArgumentNullException

De input waarde is null.

Opmerkingen

Standaard wordt een XmlUrlResolver zonder referenties gebruikt voor toegang tot externe resources, zoals een definitie van een documenttype (DTD), entiteiten, schema's enzovoort.

Important

U kunt een van de volgende methoden gebruiken om te bepalen welke resources toegankelijk XmlReader zijn:

Beperk de resources waartoe de XmlReader toegang is met behulp van ThrowingResolver.
Sta het niet toe dat XmlReader externe bronnen opent door de XmlResolver eigenschap in te stellen op null.

Het gemaakte XmlReader object breidt entiteitsverwijzingen uit en voert XML-normalisatie van nieuwe regeltekens uit.

Van toepassing op

Create(XmlReader, XmlReaderSettings)

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven XML-lezer en -instellingen.

public:
 static System::Xml::XmlReader ^ Create(System::Xml::XmlReader ^ reader, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(System.Xml.XmlReader reader, System.Xml.XmlReaderSettings settings);

public static System.Xml.XmlReader Create(System.Xml.XmlReader reader, System.Xml.XmlReaderSettings? settings);

static member Create : System.Xml.XmlReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (reader As XmlReader, settings As XmlReaderSettings) As XmlReader

Parameters

reader: XmlReader

Het object dat u wilt gebruiken als de onderliggende XML-lezer.

settings: XmlReaderSettings

De instellingen voor het nieuwe XmlReader exemplaar.

Het nalevingsniveau van het XmlReaderSettings object moet overeenkomen met het conformiteitsniveau van de onderliggende lezer of moet worden ingesteld op Auto.

Retouren

XmlReader

Een object dat rond het opgegeven XmlReader object is verpakt.

Uitzonderingen

ArgumentNullException

De reader waarde is null.

InvalidOperationException

Als het XmlReaderSettings object een nalevingsniveau opgeeft dat niet consistent is met het nalevingsniveau van de onderliggende lezer.

– of –

De onderliggende XmlReader waarde heeft een Error of Closed een status.

Voorbeelden

In het volgende voorbeeld wordt een validatieobject XmlReader gemaakt dat is verpakt rond een XmlNodeReader object.

// Create the XmlNodeReader object.
XmlDocument doc = new XmlDocument();
doc.Load("books.xml");
XmlNodeReader nodeReader = new XmlNodeReader(doc);

// Set the validation settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.Schema;
settings.Schemas.Add("urn:bookstore-schema", "books.xsd");
settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

// Create a validating reader that wraps the XmlNodeReader object.
XmlReader reader = XmlReader.Create(nodeReader, settings);
// Parse the XML file.
while (reader.Read());

' Create the XmlNodeReader object.
Dim doc As New XmlDocument()
doc.Load("books.xml")
Dim nodeReader As New XmlNodeReader(doc)

' Set the validation settings.
Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.Schema
settings.Schemas.Add("urn:bookstore-schema", "books.xsd")
AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

' Create a validating reader that wraps the XmlNodeReader object.
Dim reader As XmlReader = XmlReader.Create(nodeReader, settings)
' Parse the XML file.
While reader.Read()
End While

Opmerkingen

Met deze methode kunt u extra functies toevoegen aan een onderliggend XmlReader object. Het onderliggende XmlReader object kan een ander XmlReader object zijn dat door de Create methode wordt gemaakt of een XmlReader object dat is gemaakt met behulp van een van de concrete XmlReader implementaties.

XmlUrlResolver Er wordt standaard geen referenties gebruikt voor toegang tot externe resources, zoals een schema.

Important

Als de externe resource zich op een netwerkresource bevindt waarvoor verificatie is vereist, geeft u een XmlResolver met de benodigde referenties op met behulp van de XmlReaderSettings.XmlResolver eigenschap.

Important

U kunt een van de volgende methoden gebruiken om te bepalen welke resources toegankelijk XmlReader zijn:

Beperk de resources waartoe de XmlReader toegang is met behulp van ThrowingResolver.
Sta het niet toe dat XmlReader externe bronnen opent door de XmlResolver eigenschap in te stellen op null.

Het gemaakte XmlReader object breidt entiteitsverwijzingen uit en voert XML-normalisatie van nieuwe regeltekens uit.

Van toepassing op

Create(TextReader, XmlReaderSettings, String)

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven tekstlezer, instellingen en basis-URI.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings, System::String ^ baseUri);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, string? baseUri);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings settings, string baseUri);

static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, baseUri As String) As XmlReader

Parameters

input: TextReader

settings: XmlReaderSettings

De instellingen voor het nieuwe XmlReader exemplaar. Deze waarde kan zijn null.

baseUri: String

De basis-URI voor de entiteit of het document die wordt gelezen. Deze waarde kan zijn null.

Beveiligingsnotitie De basis-URI wordt gebruikt om de relatieve URI van het XML-document op te lossen. Gebruik geen basis-URI van een niet-vertrouwde bron.

Retouren

XmlReader

Een object dat wordt gebruikt om de XML-gegevens in de stream te lezen.

Uitzonderingen

ArgumentNullException

De input waarde is null.

Opmerkingen

Standaard wordt een XmlUrlResolver zonder referenties gebruikt voor toegang tot externe resources, zoals een definitie van een documenttype (DTD), entiteiten, schema's enzovoort.

Important

U kunt een van de volgende methoden gebruiken om te bepalen welke resources toegankelijk XmlReader zijn:

Beperk de resources waartoe de XmlReader toegang is met behulp van ThrowingResolver.
Sta het niet toe dat XmlReader externe bronnen opent door de XmlResolver eigenschap in te stellen op null.

Het gemaakte XmlReader object breidt entiteitsverwijzingen uit en voert XML-normalisatie van nieuwe regeltekens uit.

Van toepassing op

Create(TextReader, XmlReaderSettings)

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven tekstlezer en -instellingen.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings settings);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings? settings);

static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader, settings As XmlReaderSettings) As XmlReader

Parameters

input: TextReader

settings: XmlReaderSettings

De instellingen voor de nieuwe XmlReader. Deze waarde kan zijn null.

Retouren

XmlReader

Een object dat wordt gebruikt om de XML-gegevens in de stream te lezen.

Uitzonderingen

ArgumentNullException

De input waarde is null.

Opmerkingen

Standaard wordt een XmlUrlResolver zonder referenties gebruikt voor toegang tot externe resources, zoals een definitie van een documenttype (DTD), entiteiten, schema's enzovoort.

Important

U kunt een van de volgende methoden gebruiken om te bepalen welke resources toegankelijk XmlReader zijn:

Beperk de resources waartoe de XmlReader toegang is met behulp van ThrowingResolver.
Sta het niet toe dat XmlReader externe bronnen opent door de XmlResolver eigenschap in te stellen op null.

Het gemaakte XmlReader object breidt entiteitsverwijzingen uit en voert XML-normalisatie van nieuwe regeltekens uit.

Van toepassing op

Create(Stream, XmlReaderSettings)

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Hiermee maakt u een nieuw XmlReader exemplaar met de opgegeven stream en instellingen.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings settings);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings? settings);

static member Create : System.IO.Stream * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (input As Stream, settings As XmlReaderSettings) As XmlReader

Parameters

input: Stream

De stroom die de XML-gegevens bevat.

settings: XmlReaderSettings

De instellingen voor het nieuwe XmlReader exemplaar. Deze waarde kan zijn null.

Retouren

XmlReader

Een object dat wordt gebruikt om de XML-gegevens in de stream te lezen.

Uitzonderingen

ArgumentNullException

De input waarde is null.

Opmerkingen

Standaard wordt een XmlUrlResolver zonder referenties gebruikt voor toegang tot externe resources, zoals een definitie van een documenttype (DTD), entiteiten, schema's enzovoort.

Important

U kunt een van de volgende methoden gebruiken om te bepalen welke resources toegankelijk XmlReader zijn:

Beperk de resources waartoe de XmlReader toegang is met behulp van ThrowingResolver.
Sta het niet toe dat XmlReader externe bronnen opent door de XmlResolver eigenschap in te stellen op null.

Het gemaakte XmlReader object breidt entiteitsverwijzingen uit en voert XML-normalisatie van nieuwe regeltekens uit.

Van toepassing op

Create(String)

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Hiermee maakt u een nieuw XmlReader exemplaar met de opgegeven URI.

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri);

public static System.Xml.XmlReader Create(string inputUri);

static member Create : string -> System.Xml.XmlReader

Public Shared Function Create (inputUri As String) As XmlReader

Parameters

inputUri: String

De URI voor het bestand dat de XML-gegevens bevat. De XmlUrlResolver klasse wordt gebruikt om het pad te converteren naar een canonieke gegevensweergave.

Retouren

XmlReader

Een object dat wordt gebruikt om de XML-gegevens in de stream te lezen.

Uitzonderingen

ArgumentNullException

De inputUri waarde is null.

SecurityException

De XmlReader machtiging beschikt niet over voldoende machtigingen voor toegang tot de locatie van de XML-gegevens.

FileNotFoundException

Het bestand dat door de URI wordt geïdentificeerd, bestaat niet.

UriFormatException

De URI-indeling is niet juist.

Opmerking: In .NET voor Windows Store-apps of de Portable Class Library, haalt u in plaats daarvan de uitzondering van de basisklasse op, FormatException.

Voorbeelden

In het volgende voorbeeld wordt een XmlReader object gemaakt dat xml-gegevensbestand leest dat is opgegeven door de URI.

// Create the XmlReader object.
XmlReader reader = XmlReader.Create("books.xml");

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create("books.xml")

Opmerkingen

Een XmlReaderSettings object met standaardinstellingen wordt gebruikt om de lezer te maken. Als u de functies wilt opgeven die moeten worden ondersteund voor de gemaakte lezer, gebruikt u de overbelasting die een XmlReaderSettings object als een van de argumenten gebruikt en geeft u een XmlReaderSettings object door met de juiste instellingen.

Een standaard XmlUrlResolver zonder referenties wordt gebruikt voor toegang tot externe resources, zoals een definitie van een documenttype (DTD), entiteiten, schema's enzovoort.

Important

Het gemaakte XmlReader object breidt entiteitsverwijzingen uit en voert XML-normalisatie van nieuwe regeltekens uit.

Van toepassing op

Create(TextReader)

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven tekstlezer.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input);

public static System.Xml.XmlReader Create(System.IO.TextReader input);

static member Create : System.IO.TextReader -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader) As XmlReader

Parameters

input: TextReader

De tekstlezer waaruit de XML-gegevens moeten worden gelezen. Een tekstlezer retourneert een stroom Unicode-tekens, zodat de codering die is opgegeven in de XML-declaratie niet wordt gebruikt door de XML-lezer om de gegevensstroom te decoderen.

Retouren

XmlReader

Een object dat wordt gebruikt om de XML-gegevens in de stream te lezen.

Uitzonderingen

ArgumentNullException

De input waarde is null.

Voorbeelden

In het volgende voorbeeld wordt de StringReader klasse gebruikt om een XML-tekenreeks te lezen.

string xmlData ="<item productID='124390'>" +
                        "<price>5.95</price>" +
                        "</item>";

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(new StringReader(xmlData));

Dim xmlData As String = "<item productID='124390'>" & _ 
                                     "<price>5.95</price>" & _ 
                                     "</item>"

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlData))

Opmerkingen

Een standaard XmlUrlResolver zonder referenties wordt gebruikt voor toegang tot externe resources, zoals een definitie van een documenttype (DTD), entiteiten, schema's enzovoort.

Important

Het gemaakte XmlReader object breidt entiteitsverwijzingen uit en voert XML-normalisatie van nieuwe regeltekens uit.

Van toepassing op

Create(Stream)

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven stream met standaardinstellingen.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input);

public static System.Xml.XmlReader Create(System.IO.Stream input);

static member Create : System.IO.Stream -> System.Xml.XmlReader

Public Shared Function Create (input As Stream) As XmlReader

Parameters

input: Stream

De stroom die de XML-gegevens bevat.

Retouren

XmlReader

Een object dat wordt gebruikt om de XML-gegevens in de stream te lezen.

Uitzonderingen

ArgumentNullException

De input waarde is null.

SecurityException

De XmlReader machtiging beschikt niet over voldoende machtigingen voor toegang tot de locatie van de XML-gegevens.

Voorbeelden

In het volgende voorbeeld wordt een XmlReader object gemaakt dat wordt gelezen van een FileStream.


FileStream fs = new FileStream(@"C:\data\books.xml", FileMode.OpenOrCreate,
                                                                    FileAccess.Read, FileShare.Read);

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(fs);

    Dim fs As New FileStream("C:\data\books.xml", FileMode.OpenOrCreate, FileAccess.Read, FileShare.Read)
    
    ' Create the XmlReader object.
    Dim reader As XmlReader = XmlReader.Create(fs)

End Sub

Opmerkingen

Een standaard XmlUrlResolver zonder referenties wordt gebruikt voor toegang tot externe resources, zoals een definitie van een documenttype (DTD), entiteiten, schema's enzovoort.

Important

Het gemaakte XmlReader object breidt entiteitsverwijzingen uit en voert XML-normalisatie van nieuwe regeltekens uit.

Van toepassing op

Create(String, XmlReaderSettings)

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Bron:: XmlReader.cs

Hiermee maakt u een nieuw XmlReader exemplaar met behulp van de opgegeven URI en instellingen.

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings settings);

public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings? settings);

static member Create : string * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (inputUri As String, settings As XmlReaderSettings) As XmlReader

Parameters

inputUri: String

settings: XmlReaderSettings

De instellingen voor het nieuwe XmlReader exemplaar. Deze waarde kan zijn null.

Retouren

XmlReader

Een object dat wordt gebruikt om de XML-gegevens in de stream te lezen.

Uitzonderingen

ArgumentNullException

De inputUri waarde is null.

FileNotFoundException

Het bestand dat is opgegeven door de URI, kan niet worden gevonden.

UriFormatException

De URI-indeling is niet juist.

Opmerking: In .NET voor Windows Store-apps of de Portable Class Library, haalt u in plaats daarvan de uitzondering van de basisklasse op, FormatException.

Voorbeelden

In het volgende voorbeeld wordt een XmlReader object gemaakt dat DTD-validatie (documenttypedefinitie) ondersteunt.

// Set the validation settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.DtdProcessing = DtdProcessing.Parse;
settings.ValidationType = ValidationType.DTD;
settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

 // Create the XmlReader object.
XmlReader reader = XmlReader.Create("itemDTD.xml", settings);

// Parse the file.
while (reader.Read()) {}

' Set the validation settings.
Dim settings As New XmlReaderSettings()
settings.DtdProcessing = DtdProcessing.Parse
settings.ValidationType = ValidationType.DTD
AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create("itemDTD.xml", settings)

' Parse the file. 
While reader.Read()
End While

Opmerkingen

Standaard wordt een XmlUrlResolver zonder referenties gebruikt voor toegang tot externe resources, zoals een definitie van een documenttype (DTD), entiteiten, schema's enzovoort.

Important

U kunt de resources beperken waartoe ze XmlReader toegang hebben met behulp van ThrowingResolver.

Het gemaakte XmlReader object breidt entiteitsverwijzingen uit en voert XML-normalisatie van nieuwe regeltekens uit.

Van toepassing op

Feedback

Is deze pagina nuttig?