XmlReaderSettings.XmlResolver Proprietà

Definizione

Imposta l'oggetto XmlResolver usato per l'accesso a documenti esterni.Sets the XmlResolver used to access external documents.

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

Valore della proprietà

Oggetto XmlResolver usato per l'accesso a documenti esterni.An XmlResolver used to access external documents. Se il valore è impostato su null, viene generata un'eccezione XmlException quando l'oggetto XmlReader prova ad accedere a una risorsa esterna.If set to null, an XmlException is thrown when the XmlReader tries to access an external resource. L'impostazione predefinita è un nuovo oggetto XmlUrlResolver senza credenziali.The default is a new XmlUrlResolver with no credentials. A partire da .NET Framework 4.5.2, il valore predefinito di questa impostazione è null.Starting with the .NET Framework 4.5.2, this setting has a default value of null.

Esempi

Nell'esempio seguente viene creato XmlReader un oggetto che XmlSecureResolver utilizza un oggetto con credenziali predefinite.The following example creates an XmlReader that uses an XmlSecureResolver with default credentials.

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

Commenti

XmlResolver Viene utilizzato per individuare e aprire un documento di istanza XML oppure per individuare e aprire tutte le risorse esterne a cui fa riferimento il documento dell'istanza XML.The XmlResolver is used to locate and open an XML instance document, or to locate and open any external resources referenced by the XML instance document. Questo può includere entità, DTD o schemi.This can include entities, DTD, or schemas. La XmlResolver.Credentials proprietà può essere utilizzata per specificare le credenziali necessarie per l'autenticazione di rete.The XmlResolver.Credentials property can be used to specify any credentials required for network authentication.

Importante

Poiché può XmlResolver contenere informazioni riservate, ad esempio le credenziali utente, è necessario prestare attenzione quando XmlReaderSettings si memorizzano nella cache oggetti XmlReaderSettings o quando si passa l'oggetto da un componente a un altro.Because the XmlResolver can contain sensitive information such as user credentials, you should be careful when caching XmlReaderSettings objects, or when passing the XmlReaderSettings object from one component to another.

È XmlSecureResolver possibile utilizzare un oggetto per accedere a documenti esterni.An XmlSecureResolver can be used to access external documents. La XmlSecureResolver classe consente di proteggere un'altra implementazione XmlResolver di eseguendo il XmlResolver wrapping dell'oggetto e limitando le risorse a cui XmlResolver ha accesso l'oggetto sottostante.The XmlSecureResolver class helps to secure another implementation of XmlResolver by wrapping the XmlResolver object and restricting the resources that the underlying XmlResolver has access to.

Per impostazione predefinita, i flag di convalida ProcessInlineSchema e ProcessSchemaLocation dell'oggetto XmlReaderSettings non sono impostati.The ProcessInlineSchema and ProcessSchemaLocation validation flags of an XmlReaderSettings object are not set by default. Se questi flag sono impostati, verrà utilizzata la proprietà XmlResolver dell'oggetto XmlReaderSettings per risolvere i percorsi dello schema rilevati nel documento di istanza nel tipo XmlReader.When these flags are set, the XmlResolver of the XmlReaderSettings object is used to resolve schema locations encountered in the instance document in the XmlReader. Se l' XmlResolver oggetto è null, i percorsi dello schema non vengono risolti ProcessInlineSchema anche ProcessSchemaLocation se i flag di convalida e sono impostati.If the XmlResolver object is null, schema locations are not resolved even if the ProcessInlineSchema and ProcessSchemaLocation validation flags are set.

Gli schemi aggiunti durante la convalida aggiungono nuovi tipi e possono alterare l'esito della convalida del documento in esame.Schemas added during validation add new types and can change the validation outcome of the document being validated. Di conseguenza, gli schemi esterni devono essere risolti solo da origini attendibili.As a result, external schemas should only be resolved from trusted sources.

Si applica a

Vedi anche