XmlReaderSettings.ConformanceLevel Egenskap

public:
 property System::Xml::ConformanceLevel ConformanceLevel { System::Xml::ConformanceLevel get(); void set(System::Xml::ConformanceLevel value); };

public System.Xml.ConformanceLevel ConformanceLevel { get; set; }

member this.ConformanceLevel : System.Xml.ConformanceLevel with get, set

Public Property ConformanceLevel As ConformanceLevel

Egenskapsvärde

Ett av uppräkningsvärdena som anger den nivå av överensstämmelse som XML-läsaren ska tillämpa. Standardvärdet är Document.

Exempel

I följande exempel skapas ett XmlReader objekt som läser ett XML-fragment.

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)

Kommentarer

XML-läsare som skapas av Create metoden uppfyller följande efterlevnadskrav som standard:

• Nya rader och attributvärde normaliseras enligt W3C XML 1.0-rekommendationen.

• Alla entiteter expanderas automatiskt.

• Standardattribut som deklareras i dokumenttypsdefinitionen läggs alltid till även när läsaren inte verifierar.

• Deklaration av XML-prefix som mappats till rätt XML-namnområdes-URI tillåts.

• Notationsnamnen i en enda NotationType attributdeklaration och NmTokens i en enda Enumeration attributdeklaration är distinkta.

Du kan använda ConformanceLevel egenskapen för att kontrollera och garantera att dataströmmen som läss följer reglerna för ett välformat XML 1.0-dokument eller dokumentfragment. Om data inte uppfyller kraven utlöses ett XmlException undantag. Standardvärdet är ConformanceLevel.Document (överensstämmelse på dokumentnivå).

De tre överensstämmelsenivåerna är:

Så här hanterar läsaren specifika efterlevnadsöverträdelser beroende på egenskapens ConformanceLevel inställning:

Se även

• Create(String)