XmlReaderSettings.XmlResolver XmlReaderSettings.XmlResolver XmlReaderSettings.XmlResolver XmlReaderSettings.XmlResolver Property

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

L'esempio seguente crea un XmlReader che usa un XmlSecureResolver 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

Il XmlResolver viene utilizzato per individuare e aprire un documento di istanza XML, o per individuare e aprire eventuali risorse esterne fa riferimento il documento di 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. Può trattarsi di entità, DTD o schemi.This can include entities, DTD, or schemas. Il 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é il XmlResolver possono contenere informazioni sensibili quali le credenziali utente, è necessario prestare attenzione quando la memorizzazione nella cache XmlReaderSettings oggetti, o quando si passa il XmlReaderSettings 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.

Un XmlSecureResolver può essere utilizzato per accedere a documenti esterni.An XmlSecureResolver can be used to access external documents. Il XmlSecureResolver consente di proteggere un'altra implementazione della classe XmlResolver eseguendo il wrapping il XmlResolver oggetto e limitare le risorse che sottostante XmlResolver può accedere a.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 il XmlResolver oggetto viene null, percorsi dello schema non verranno risolti anche se il ProcessInlineSchema e ProcessSchemaLocation vengono impostati i flag di convalida.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