XmlReaderSettings.XmlResolver Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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 null
objekt , 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ů.