XmlReaderSettings.XmlResolver Eigenschap
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.
Hiermee stelt u de XmlResolver gebruikte voor toegang tot externe documenten in.
public:
property System::Xml::XmlResolver ^ XmlResolver { void set(System::Xml::XmlResolver ^ value); };public System.Xml.XmlResolver? XmlResolver { set; }public System.Xml.XmlResolver XmlResolver { set; }member this.XmlResolver : System.Xml.XmlResolverPublic Property XmlResolver As XmlResolverWaarde van eigenschap
Een XmlResolver gebruikt om toegang te krijgen tot externe documenten. Als deze optie is ingesteld null, wordt er een XmlException gegenereerd wanneer de XmlReader toegang tot een externe resource wordt geprobeerd. De standaardwaarde is een nieuw XmlUrlResolver zonder referenties. Vanaf het .NET Framework 4.5.2 heeft deze instelling een standaardwaarde van null.
Voorbeelden
In het volgende voorbeeld wordt een XmlReaderXmlSecureResolver met standaardreferenties gemaakt.
// Create an XmlSecureResolver with default credentials.
XmlSecureResolver myResolver = new XmlSecureResolver(new XmlUrlResolver(), "http://serverName/data/");
myResolver.Credentials = CredentialCache.DefaultCredentials;
XmlReaderSettings settings = new XmlReaderSettings();
settings.XmlResolver = myResolver;
// Create the reader.
XmlReader reader = XmlReader.Create("http://serverName/data/books.xml", settings);
' Create an XmlSecureResolver with default credentials.
Dim myResolver As New XmlSecureResolver(New XmlUrlResolver(), "http://serverName/data/")
myResolver.Credentials = CredentialCache.DefaultCredentials
Dim settings As New XmlReaderSettings()
settings.XmlResolver = myResolver
' Create the reader.
Dim reader As XmlReader = XmlReader.Create("http://serverName/data/books.xml", settings)
Opmerkingen
Het XmlResolver wordt gebruikt om een XML-exemplaardocument te zoeken en te openen, of om externe resources te zoeken en te openen waarnaar wordt verwezen door het XML-exemplaardocument. Dit kunnen entiteiten, DTD of schema's zijn. De XmlResolver.Credentials eigenschap kan worden gebruikt om referenties op te geven die vereist zijn voor netwerkverificatie.
Important
Omdat het XmlResolver gevoelige informatie zoals gebruikersreferenties kan bevatten, moet u voorzichtig zijn bij het opslaan van objecten in de cache XmlReaderSettings of bij het doorgeven van het object van het ene onderdeel aan het XmlReaderSettings andere.
Een XmlSecureResolver kan worden gebruikt voor toegang tot externe documenten. De XmlSecureResolver klasse helpt bij het beveiligen van een andere implementatie door XmlResolver het XmlResolver object te verpakken en de resources te beperken waartoe de onderliggende XmlResolver gegevens toegang hebben.
De ProcessInlineSchema en ProcessSchemaLocation validatievlagmen van een XmlReaderSettings object zijn niet standaard ingesteld. Wanneer deze vlaggen zijn ingesteld, wordt het XmlResolver-object van XmlReaderSettings gebruikt om schemalocaties, die zijn aangetroffen in het exemplaardocument in de XmlReader, op te lossen. Als het XmlResolver object null is, worden schemalocaties niet opgelost, zelfs niet als de ProcessInlineSchema en ProcessSchemaLocation validatievlaggen zijn ingesteld.
Schema's die tijdens de validatie zijn toegevoegd, voegen nieuwe typen toe en kunnen het validatieresultaat van het document dat wordt gevalideerd, wijzigen. Als gevolg hiervan mogen externe schema's alleen worden omgezet vanuit vertrouwde bronnen.
