XmlReaderSettings.XmlResolver Vlastnost

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlReaderSettings.cs

XmlResolver Nastaví použitou 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; }

member this.XmlResolver : System.Xml.XmlResolver

Public Property XmlResolver As XmlResolver

Hodnota vlastnosti

XmlResolver

Slouží XmlResolver k přístupu 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 rozhraním .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í jakýchkoli externích prostředků odkazovaných dokumentem instance XML. Může to zahrnovat entity, DTD nebo schémata. Vlastnost XmlResolver.Credentials lze použít k zadání libovolných přihlašovacích údajů požadovaných pro ověření 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 druhé.

Dá XmlSecureResolver se 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ý XmlResolver objekt přístup.

Příznaky ProcessInlineSchema a ProcessSchemaLocation objektu XmlReaderSettings nejsou ve výchozím nastavení nastaveny. Když jsou tyto příznaky nastaveny, XmlResolver objektu XmlReaderSettings je použit k určení umístění schémat nalezených v dokumentu instance v XmlReader. XmlResolver Pokud je objekt null, umístění schématu nejsou vyřešena, i když jsou příznaky ověřování ProcessInlineSchema a ProcessSchemaLocation nastaveny.

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

Viz také

• XmlReader
• Create(String)