XmlValidatingReader Constructors
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Initializes a new instance of the XmlValidatingReader class.
Overloads
| XmlValidatingReader(XmlReader) |
Initializes a new instance of the |
| XmlValidatingReader(Stream, XmlNodeType, XmlParserContext) |
Initializes a new instance of the |
| XmlValidatingReader(String, XmlNodeType, XmlParserContext) |
Initializes a new instance of the |
XmlValidatingReader(XmlReader)
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
Initializes a new instance of the XmlValidatingReader class that validates the content returned from the given 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
The XmlReader to read from while validating. The current implementation supports only XmlTextReader.
Exceptions
The reader specified is not an XmlTextReader.
Remarks
Note
The XmlValidatingReader class is obsolete in .NET Framework 2.0. You can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. For more information, see the Remarks section of the XmlReader reference page.
All nodes returned from the given XmlReader are also returned from this validating reader, so there is no information loss in the process. New nodes not returned from the underlying reader may be added by this reader (for example, default attributes and the children of an entity reference). Any properties set on the given XmlTextReader also apply to this validating reader. For example, if the supplied reader had WhitespaceHandling.None set, this validating reader also ignores white space.
When external document type definitions (DTDs) or schemas are needed for validation, the XmlResolver property sets the XmlResolver object to use for resolving external resources.
See also
Applies to
XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
Initializes a new instance of the XmlValidatingReader class with the specified values.
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
The stream containing the XML fragment to parse.
- fragType
- XmlNodeType
The XmlNodeType of the XML fragment. This determines what the fragment can contain (see table below).
- context
- XmlParserContext
The XmlParserContext in which the XML fragment is to be parsed. This includes the XmlNameTable to use, encoding, namespace scope, current xml:lang, and xml:space scope.
Exceptions
fragType is not one of the node types listed in the table below.
Remarks
Note
The XmlValidatingReader class is obsolete in .NET Framework 2.0. You can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. For more information, see the Remarks section of the XmlReader reference page.
This constructor parses the given string as a fragment of XML. If the XML fragment is an element or attribute, you can bypass the root level rules for well-formed XML documents.
The following table lists valid values for fragType and how the reader parses each of the different node types.
| XmlNodeType | Fragment May Contain |
|---|---|
| Element | Any valid element content (for example, any combination of elements, comments, processing instructions, cdata, text, and entity references). |
| Attribute | The value of an attribute (the part inside the quotes). |
| Document | The contents of an entire XML document; this enforces document level rules. |
The reader uses the following steps to determine the encoding of the stream:
Checks the XmlParserContext.Encoding property to determine the encoding.
If the
Encodingproperty isnull, the reader checks for a byte-order mark at the beginning of the stream.If the
Encodingproperty isnull, and no byte-order mark is found, the reader assumes the stream is encoded in UTF-8.
If this reader will be validating using document type definition (DTD) (that is, ValidationType is set to ValidationType.DTD or ValidationType.Auto), the XmlParserContext specified in the constructor must supply all the necessary DocumentType information.
Note
It is not possible to validate a fragment by using a DTD. By definition a DTD requires an entire document to be loaded for validation.
If this reader will be validating by using XML-Data Reduced (XDR) or XML Schema definition language (XSD) schemas, use the Schemas property to specify the XmlSchemaCollection that contains the schemas (that is, the XmlParserContext does not need to supply the DocumentType information).
See also
Applies to
XmlValidatingReader(String, XmlNodeType, XmlParserContext)
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
Initializes a new instance of the XmlValidatingReader class with the specified values.
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
The string containing the XML fragment to parse.
- fragType
- XmlNodeType
The XmlNodeType of the XML fragment. This also determines what the fragment string can contain (see table below).
- context
- XmlParserContext
The XmlParserContext in which the XML fragment is to be parsed. This includes the NameTable to use, encoding, namespace scope, current xml:lang, and xml:space scope.
Exceptions
fragType is not one of the node types listed in the table below.
Remarks
Note
The XmlValidatingReader class is obsolete in .NET Framework 2.0. You can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. For more information, see the Remarks section of the XmlReader reference page.
This constructor parses the given string as a fragment of XML. If the XML fragment is an element or attribute, you can bypass the root level rules for well-formed XML documents. This constructor can handle strings returned from ReadInnerXml.
The following table lists valid values for fragType and how the reader parses each of the different node types.
| XmlNodeType | Fragment May Contain |
|---|---|
| Element | Any valid element content (for example, any combination of elements, comments, processing instructions, cdata, text, and entity references). |
| Attribute | The value of an attribute (the part inside the quotes). |
| Document | The contents of an entire XML document; this enforces document level rules. |
If this reader will be validating by using document type definition (DTD) (that is, ValidationType is set to ValidationType.DTD or ValidationType.Auto), the XmlParserContext specified in the constructor must supply all the necessary DocumentType information.
Note
It is not possible to validate a fragment by using DTD. By definition DTD requires an entire document to be loaded for validation.
If this reader will be validating by using XML-Data Reduced (XDR) or XML Schema definition language (XSD) schemas, use the Schemas property to specify the XmlSchemaCollection that contains the schemas (the XmlParserContext does not need to supply the DocumentType information).
