XmlReaderSettings.XmlResolver Vlastnost

Definice

XmlResolver Nastaví použité pro přístup k externím dokumentům.

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.XmlResolver
Public Property XmlResolver As XmlResolver

Hodnota vlastnosti

XmlResolver

Používá XmlResolver se pro přístup k externím dokumentům. Pokud je nastavená hodnota null, vyvolá se při XmlException pokusu XmlReader o přístup k externímu prostředku. Výchozí hodnota je nová XmlUrlResolver bez přihlašovacích údajů. Počínaje .NET Framework 4.5.2 má toto nastavení výchozí hodnotu null.

Příklady

Následující příklad vytvoří, XmlReader který používá XmlSecureResolver s výchozími přihlašovacími údaji.

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

Poznámky

Slouží XmlResolver k vyhledání a otevření dokumentu instance XML nebo k vyhledání a otevření všech externích prostředků odkazovaných dokumentem instance XML. To může zahrnovat entity, DTD nebo schémata. Vlastnost XmlResolver.Credentials lze použít k zadání libovolných přihlašovacích údajů vyžadovaných pro ověřování sítě.

Důležité

XmlResolver Protože může obsahovat citlivé informace, jako jsou přihlašovací údaje uživatele, měli byste být opatrní při ukládání objektů do mezipaměti XmlReaderSettings nebo při předávání objektu XmlReaderSettings z jedné komponenty do jiné.

Lze XmlSecureResolver použít pro přístup k externím dokumentům. Třída XmlSecureResolver pomáhá zabezpečit další implementaci XmlResolver zabalením objektu XmlResolver a omezením prostředků, ke kterým má podkladový zdroj XmlResolver přístup.

Příznaky ProcessInlineSchema ověřování ProcessSchemaLocation objektu XmlReaderSettings nejsou ve výchozím nastavení nastavené. Pokud jsou tyto příznaky nastaveny, XmlResolver XmlReaderSettings objekt se používá k překladu umístění schématu, ke kterým došlo v dokumentu instance v souboru XmlReader. XmlResolver Pokud je nullobjekt , umístění schématu nejsou vyřešena, i když ProcessInlineSchema jsou nastavené příznaky ověřováníProcessSchemaLocation.

Schémata přidaná během ověřování přidávají nové typy a můžou změnit ověřovací výsledek ověřovaného dokumentu. V důsledku toho by se externí schémata měla přeložit pouze z důvěryhodných zdrojů.

Platí pro

Viz také