XmlValidatingReader Constructors
Definitie
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.
Initialiseert een nieuw exemplaar van de XmlValidatingReader klasse.
Overloads
| Name | Description |
|---|---|
| XmlValidatingReader(XmlReader) |
Initialiseert een nieuw exemplaar van de |
| XmlValidatingReader(Stream, XmlNodeType, XmlParserContext) |
Initialiseert een nieuw exemplaar van de |
| XmlValidatingReader(String, XmlNodeType, XmlParserContext) |
Initialiseert een nieuw exemplaar van de |
XmlValidatingReader(XmlReader)
Initialiseert een nieuw exemplaar van de XmlValidatingReader klasse waarmee de inhoud wordt gevalideerd die is geretourneerd door de opgegeven XmlReader.
public:
XmlValidatingReader(System::Xml::XmlReader ^ reader);public XmlValidatingReader(System.Xml.XmlReader reader);new System.Xml.XmlValidatingReader : System.Xml.XmlReader -> System.Xml.XmlValidatingReaderPublic Sub New (reader As XmlReader)Parameters
- reader
- XmlReader
De XmlReader te lezen waaruit tijdens het valideren wordt gelezen. De huidige implementatie ondersteunt alleen XmlTextReader.
Uitzonderingen
De opgegeven lezer is geen XmlTextReader.
Opmerkingen
Note
De klasse XmlValidatingReader is verouderd in .NET Framework 2.0. U kunt een validatie-exemplaar XmlReader maken met behulp van de XmlReaderSettings klasse en de Create methode. Zie de sectie Opmerkingen van de XmlReader referentiepagina voor meer informatie.
Alle knooppunten die worden geretourneerd van de opgegeven XmlReader , worden ook geretourneerd door deze validatielezer, dus er is geen informatieverlies in het proces. Nieuwe knooppunten die niet worden geretourneerd door de onderliggende lezer, kunnen door deze lezer worden toegevoegd (bijvoorbeeld standaardkenmerken en de onderliggende kenmerken van een entiteitsreferentie). Alle eigenschappen die op de opgegeven XmlTextReader waarden zijn ingesteld, zijn ook van toepassing op deze geldige lezer. Als de opgegeven lezer bijvoorbeeld WhitespaceHandling.None heeft ingesteld, negeert deze validatielezer ook witruimte.
Wanneer definities van externe documenttypen (DTD's) of schema's nodig zijn voor validatie, stelt de XmlResolver eigenschap het object in dat moet worden gebruikt voor het XmlResolver omzetten van externe resources.
Zie ook
Van toepassing op
XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)
Initialiseert een nieuw exemplaar van de XmlValidatingReader klasse met de opgegeven waarden.
public:
XmlValidatingReader(System::IO::Stream ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);public XmlValidatingReader(System.IO.Stream xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);new System.Xml.XmlValidatingReader : System.IO.Stream * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlValidatingReaderPublic Sub New (xmlFragment As Stream, fragType As XmlNodeType, context As XmlParserContext)Parameters
- xmlFragment
- Stream
De stream met het XML-fragment dat moet worden geparseerd.
- fragType
- XmlNodeType
Het XmlNodeType XML-fragment. Hiermee bepaalt u wat het fragment kan bevatten (zie de onderstaande tabel).
- context
- XmlParserContext
Het XmlParserContext XML-fragment moet worden geparseerd. Dit omvat het XmlNameTable te gebruiken, coderen, naamruimtebereik, huidige xml:langen xml:space bereik.
Uitzonderingen
fragType is geen van de knooppunttypen die worden vermeld in de onderstaande tabel.
Opmerkingen
Note
De klasse XmlValidatingReader is verouderd in .NET Framework 2.0. U kunt een validatie-exemplaar XmlReader maken met behulp van de XmlReaderSettings klasse en de Create methode. Zie de sectie Opmerkingen van de XmlReader referentiepagina voor meer informatie.
Met deze constructor wordt de opgegeven tekenreeks geparseerd als een fragment van XML. Als het XML-fragment een element of kenmerk is, kunt u de basisregels voor goed opgemaakte XML-documenten omzeilen.
De volgende tabel bevat geldige waarden voor fragType en hoe de lezer elk van de verschillende knooppunttypen parseert.
| XmlNodeType | Fragment kan bevatten |
|---|---|
| Element | Alle geldige elementinhoud (bijvoorbeeld een combinatie van elementen, opmerkingen, verwerkingsinstructies, cdata, tekst en entiteitsverwijzingen). |
| Attribute | De waarde van een kenmerk (het deel tussen de aanhalingstekens). |
| Document | De inhoud van een heel XML-document; hiermee worden regels op documentniveau afgedwongen. |
De lezer gebruikt de volgende stappen om de codering van de stream te bepalen:
Controleert de XmlParserContext.Encoding eigenschap om de codering te bepalen.
Als de
Encodingeigenschap isnull, controleert de lezer op een bytevolgordemarkering aan het begin van de stream.Als de
Encodingeigenschap isnullen er geen bytevolgordemarkering wordt gevonden, gaat de lezer ervan uit dat de stream is gecodeerd in UTF-8.
Als deze lezer valideert met de definitie van het documenttype (DTD) (dat wil gezegd, ValidationType is ingesteld op ValidationType.DTD of ValidationType.Auto), moet de XmlParserContext opgegeven in de constructor alle benodigde DocumentType-informatie opgeven.
Note
Het is niet mogelijk om een fragment te valideren met behulp van een DTD. Voor een DTD moet per definitie een volledig document worden geladen voor validatie.
Als deze lezer valideert met behulp van XML-Data Gereduceerde (XDR) of XSD-schema's (XML Schema Definition Language), gebruikt u de Schemas eigenschap om de XmlSchemaCollection schema's op te geven (dat wil gezegd, het XmlParserContext hoeft niet de DocumentType-informatie op te geven).
Zie ook
Van toepassing op
XmlValidatingReader(String, XmlNodeType, XmlParserContext)
Initialiseert een nieuw exemplaar van de XmlValidatingReader klasse met de opgegeven waarden.
public:
XmlValidatingReader(System::String ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);public XmlValidatingReader(string xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);new System.Xml.XmlValidatingReader : string * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlValidatingReaderPublic Sub New (xmlFragment As String, fragType As XmlNodeType, context As XmlParserContext)Parameters
- xmlFragment
- String
De tekenreeks met het XML-fragment dat moet worden geparseerd.
- fragType
- XmlNodeType
Het XmlNodeType XML-fragment. Dit bepaalt ook wat de fragmenttekenreeks kan bevatten (zie de onderstaande tabel).
- context
- XmlParserContext
Het XmlParserContext XML-fragment moet worden geparseerd. Dit omvat het NameTable te gebruiken, coderen, naamruimtebereik, huidige xml:lang en xml:space scope.
Uitzonderingen
fragType is geen van de knooppunttypen die worden vermeld in de onderstaande tabel.
Opmerkingen
Note
De klasse XmlValidatingReader is verouderd in .NET Framework 2.0. U kunt een validatie-exemplaar XmlReader maken met behulp van de XmlReaderSettings klasse en de Create methode. Zie de sectie Opmerkingen van de XmlReader referentiepagina voor meer informatie.
Met deze constructor wordt de opgegeven tekenreeks geparseerd als een fragment van XML. Als het XML-fragment een element of kenmerk is, kunt u de basisregels voor goed opgemaakte XML-documenten omzeilen. Deze constructor kan tekenreeksen verwerken die worden geretourneerd door ReadInnerXml.
De volgende tabel bevat geldige waarden voor fragType en hoe de lezer elk van de verschillende knooppunttypen parseert.
| XmlNodeType | Fragment kan bevatten |
|---|---|
| Element | Alle geldige elementinhoud (bijvoorbeeld een combinatie van elementen, opmerkingen, verwerkingsinstructies, cdata, tekst en entiteitsverwijzingen). |
| Attribute | De waarde van een kenmerk (het deel tussen de aanhalingstekens). |
| Document | De inhoud van een heel XML-document; hiermee worden regels op documentniveau afgedwongen. |
Als deze lezer valideert met behulp van de definitie van het documenttype (DTD) (dat wil gezegd, ValidationType is ingesteld op ValidationType.DTD of ValidationType.Auto), moet de XmlParserContext opgegeven in de constructor alle benodigde DocumentType-informatie opgeven.
Note
Het is niet mogelijk om een fragment te valideren met behulp van DTD. Voor DTD moet per definitie een volledig document worden geladen voor validatie.
Als deze lezer valideert met behulp van XML-Data Gereduceerde (XDR) of XSD-schema's (XML Schema Definition Language), gebruikt u de Schemas eigenschap om de XmlSchemaCollection schema's op te geven (het XmlParserContext hoeft de DocumentType-informatie niet op te geven).
