XmlReader.Create Methode

Definitie

Naamruimte:: System.Xml

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

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

Assembly:: 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.

Opmerkingen

Zie Aanvullende API-opmerkingen voor XmlReader.Close voor meer informatie over deze API.

Create(String, XmlReaderSettings, XmlParserContext)

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);

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 de XmlReader toegang kan worden beperkt door de XmlResolver eigenschap in te stellen op een XmlSecureResolver object.

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

Van toepassing op

Create(TextReader, XmlReaderSettings, XmlParserContext)

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);

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 eigenschap toegang heeft door de XmlResolver eigenschap in te stellen op een XmlSecureResolver object.

– of –

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)

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);

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 eigenschap toegang heeft door de XmlResolver eigenschap in te stellen op een XmlSecureResolver object.

– of –

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)

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);

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 eigenschap toegang heeft door de XmlResolver eigenschap in te stellen op een XmlSecureResolver object.

– of –

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)

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);

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 eigenschap toegang heeft door de XmlResolver eigenschap in te stellen op een XmlSecureResolver object.

– of –

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)

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);

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 eigenschap toegang heeft door de XmlResolver eigenschap in te stellen op een XmlSecureResolver object.

– of –

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)

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);

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 eigenschap toegang heeft door de XmlResolver eigenschap in te stellen op een XmlSecureResolver object.

– of –

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)

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);

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 eigenschap toegang heeft door de XmlResolver eigenschap in te stellen op een XmlSecureResolver object.

– of –

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)

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)

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)

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)

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);

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 de XmlReader toegang kan worden beperkt door de XmlResolver eigenschap in te stellen op een XmlSecureResolver object.

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

Van toepassing op

Feedback

Is deze pagina nuttig?