XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings Class

Definizione

Specifica un set di funzionalità da supportare nell'oggetto XmlReader creato dal metodo Create.Specifies a set of features to support on the XmlReader object created by the Create method.

public ref class XmlReaderSettings sealed
public sealed class XmlReaderSettings
type XmlReaderSettings = class
Public NotInheritable Class XmlReaderSettings
Ereditarietà
XmlReaderSettingsXmlReaderSettingsXmlReaderSettingsXmlReaderSettings

Esempi

Nell'esempio seguente viene creato XmlReader un oggetto che XmlUrlResolver utilizza un con le credenziali necessarie.The following example creates an XmlReader that uses an XmlUrlResolver with the necessary credentials.

// Create an XmlUrlResolver with the credentials necessary to access the Web server.
XmlUrlResolver resolver = new XmlUrlResolver();
System.Net.NetworkCredential myCred;
myCred  = new System.Net.NetworkCredential(UserName,SecurelyStoredPassword,Domain);  
resolver.Credentials = myCred;

XmlReaderSettings settings = new XmlReaderSettings();
settings.XmlResolver = resolver;

// Create the reader.
XmlReader reader = XmlReader.Create("http://serverName/data/books.xml", settings);
' Create an XmlUrlResolver with the credentials necessary to access the Web server.
Dim resolver As New XmlUrlResolver()
Dim myCred As System.Net.NetworkCredential
myCred = New System.Net.NetworkCredential(UserName, SecurelyStoredPassword, Domain)
resolver.Credentials = myCred

Dim settings As New XmlReaderSettings()
settings.XmlResolver = resolver

' Create the reader.
Dim reader As XmlReader = XmlReader.Create("http://serverName/data/books.xml", settings)

Commenti

Usare il metodo Create per ottenere XmlReader le istanze.You use the Create method to obtain XmlReader instances. Questo metodo usa la XmlReaderSettings classe per specificare le funzionalità da implementare XmlReader nell'oggetto creato.This method uses the XmlReaderSettings class to specify which features to implement in the XmlReader object it creates.

Vedere le sezioni note delle pagine XmlReader di Create riferimento e per informazioni sulle impostazioni da usare per i controlli di conformità, la convalida e altri scenari comuni.See the Remarks sections of the XmlReader and Create reference pages for information about which settings to use for conformance checks, validation, and other common scenarios. Per un XmlReaderSettings() elenco delle impostazioni predefinite, vedere il costruttore.See the XmlReaderSettings() constructor for a list of default settings.

Considerazioni sulla sicurezzaSecurity considerations

Quando si usa la XmlReaderSettings classe, tenere presente quanto segue.Consider the following when using the XmlReaderSettings class.

  • 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.

  • I messaggi di errore di convalida possono esporre informazioni sul modello di contenuto sensibile.Validation error messages may expose sensitive content model information. I messaggi di errore e di avviso di convalida ValidationEventHandler vengono gestiti mediante il delegato oppure vengono XmlSchemaValidationException esposti come se all'oggetto non venisse fornito XmlReaderSettings alcun gestore eventi (gli avvisi di convalida XmlSchemaValidationException non determinano la generazione di un'eccezione).Validation error and warning messages are handled using the ValidationEventHandler delegate, or are exposed as an XmlSchemaValidationException if no event handler is provided to the XmlReaderSettings object (validation warnings do not cause an XmlSchemaValidationException to be thrown). Queste informazioni sul modello di contenuto non devono essere esposte in scenari non attendibili.This content model information should not be exposed in untrusted scenarios. Per impostazione predefinita, i messaggi di avviso di convalida vengono eliminati e possono essere ReportValidationWarnings segnalati impostando il flag.Validation warning messages are suppressed by default and can be reported by setting the ReportValidationWarnings flag.

  • La SourceUri proprietà di un XmlSchemaValidationException oggetto restituisce il percorso URI del file di schema che ha causato l'eccezione.The SourceUri property of an XmlSchemaValidationException returns the URI path to the schema file that caused the exception. La SourceUri proprietà non deve essere esposta in scenari non attendibili.The SourceUri property should not be exposed in untrusted scenarios.

  • La disabilitazione ProcessIdentityConstraints del flag (abilitata per impostazione predefinita) è consigliata per la convalida, i documenti XML di grandi dimensioni e non attendibili in scenari a disponibilità elevata rispetto a uno schema con vincoli di identità in una parte significativa del documento.Disabling the ProcessIdentityConstraints flag (enabled by default) is recommended when validating, untrusted, large XML documents in high availability scenarios against a schema with identity constraints over a large part of the document.

  • Gli oggetti XmlReaderSettings possono contenere informazioni sensibili quali le credenziali utente.XmlReaderSettings objects can contain sensitive information such as user credentials. È necessario prestare attenzione quando si memorizzano nella cache oggetti XmlReaderSettings o quando si passa l'oggetto XmlReaderSettings da un componente a un altro.You should be careful when caching XmlReaderSettings objects, or when passing the XmlReaderSettings object from one component to another.

  • Per impostazione predefinita, l'elaborazione della DTD è disabilitata.DTD processing is disabled by default. Se si Abilita l'elaborazione DTD, è necessario essere consapevoli di includere DTD da origini non attendibili e di possibili attacchi Denial of Service.If you enable DTD processing, you need to be aware of including DTDs from untrusted sources and possible denial of service attacks. Usare per limitare le risorse a XmlReader cui può accedere. XmlSecureResolverUse the XmlSecureResolver to restrict the resources that the XmlReader can access.

  • Non accettare componenti di supporto, ad esempio oggetti NameTable, XmlNamespaceManager e XmlResolver da un'origine non attendibile.Do not accept supporting components, such as NameTable, XmlNamespaceManager, and XmlResolver objects, from an untrusted source.

  • L'utilizzo della memoria di un'applicazione che usa XmlReader può essere correlato alle dimensioni del documento XML analizzato.Memory usage of an application that uses XmlReader may have a correlation to the size of the parsed XML document. Quando per l'analisi vengono inviati documenti XML di dimensioni eccessive, si verifica un attacco di tipo DoS.One form of denial of service attack is when excessively large XML documents are submitted to be parsed. È possibile limitare le dimensioni del documento che possono essere analizzate impostando la MaxCharactersInDocument proprietà e quindi limitare il numero di caratteri risultante dall'espansione delle entità impostando la MaxCharactersFromEntities proprietà.You can limit the size of the document that can be parsed by setting the MaxCharactersInDocument property and then limit the number of characters that result from expanding entities by setting the MaxCharactersFromEntities property.

Costruttori

XmlReaderSettings() XmlReaderSettings() XmlReaderSettings() XmlReaderSettings()

Inizializza una nuova istanza della classe XmlReaderSettings.Initializes a new instance of the XmlReaderSettings class.

XmlReaderSettings(XmlResolver) XmlReaderSettings(XmlResolver) XmlReaderSettings(XmlResolver) XmlReaderSettings(XmlResolver)

Inizializza una nuova istanza della classe XmlReaderSettings.Initializes a new instance of the XmlReaderSettings class.

Proprietà

Async Async Async Async

Ottiene o imposta un valore che indica se è possibile usare metodi XmlReader asincroni in una determinata istanza di XmlReader.Gets or sets whether asynchronous XmlReader methods can be used on a particular XmlReader instance.

CheckCharacters CheckCharacters CheckCharacters CheckCharacters

Ottiene o imposta un valore che indica se eseguire il controllo dei caratteri.Gets or sets a value indicating whether to do character checking.

CloseInput CloseInput CloseInput CloseInput

Ottiene o imposta un valore che indica se il flusso o la classe TextReader sottostante devono essere chiusi alla chiusura del visualizzatore.Gets or sets a value indicating whether the underlying stream or TextReader should be closed when the reader is closed.

ConformanceLevel ConformanceLevel ConformanceLevel ConformanceLevel

Ottiene o imposta il livello di conformità dell'oggetto XmlReader.Gets or sets the level of conformance which the XmlReader will comply.

DtdProcessing DtdProcessing DtdProcessing DtdProcessing

Ottiene o imposta un valore che determina l'elaborazione di DTD.Gets or sets a value that determines the processing of DTDs.

IgnoreComments IgnoreComments IgnoreComments IgnoreComments

Ottiene o imposta un valore che indica se ignorare i commenti.Gets or sets a value indicating whether to ignore comments.

IgnoreProcessingInstructions IgnoreProcessingInstructions IgnoreProcessingInstructions IgnoreProcessingInstructions

Ottiene o imposta un valore che indica se ignorare le istruzioni di elaborazione.Gets or sets a value indicating whether to ignore processing instructions.

IgnoreWhitespace IgnoreWhitespace IgnoreWhitespace IgnoreWhitespace

Ottiene o imposta un valore che indica se ignorare gli spazi vuoti non significativi.Gets or sets a value indicating whether to ignore insignificant white space.

LineNumberOffset LineNumberOffset LineNumberOffset LineNumberOffset

Ottiene o imposta l'offset del numero di riga dell'oggetto XmlReader.Gets or sets line number offset of the XmlReader object.

LinePositionOffset LinePositionOffset LinePositionOffset LinePositionOffset

Ottiene o imposta l'offset della posizione della riga dell'oggetto XmlReader.Gets or sets line position offset of the XmlReader object.

MaxCharactersFromEntities MaxCharactersFromEntities MaxCharactersFromEntities MaxCharactersFromEntities

Ottiene o imposta un valore che indica il numero massimo di caratteri consentito in un documento generato dall'espansione delle entità.Gets or sets a value indicating the maximum allowable number of characters in a document that result from expanding entities.

MaxCharactersInDocument MaxCharactersInDocument MaxCharactersInDocument MaxCharactersInDocument

Ottiene o imposta un valore che indica il numero massimo di caratteri consentito in un documento XML.Gets or sets a value indicating the maximum allowable number of characters in an XML document. Un valore zero (0) indica che non è previsto alcun limite alla dimensione del documento XML.A zero (0) value means no limits on the size of the XML document. Un valore diverso da zero specifica la dimensione massima in caratteri.A non-zero value specifies the maximum size, in characters.

NameTable NameTable NameTable NameTable

Ottiene o imposta l'oggetto XmlNameTable usato per il confronto delle stringhe atomizzate.Gets or sets the XmlNameTable used for atomized string comparisons.

ProhibitDtd ProhibitDtd ProhibitDtd ProhibitDtd

Ottiene o imposta un valore che indica se non deve essere consentita l'elaborazione DTD (Document Type Definition).Gets or sets a value indicating whether to prohibit document type definition (DTD) processing. Questa proprietà è obsoleta.This property is obsolete. In alternativa, utilizzare DtdProcessing.Use DtdProcessing instead.

Schemas Schemas Schemas Schemas

Ottiene o imposta l'oggetto XmlSchemaSet da usare quando si esegue la convalida dello schema.Gets or sets the XmlSchemaSet to use when performing schema validation.

ValidationFlags ValidationFlags ValidationFlags ValidationFlags

Ottiene o imposta un valore che indica le impostazioni di convalida dello schema.Gets or sets a value indicating the schema validation settings. Questa impostazione si applica a oggetti XmlReader che convalidano schemi (proprietà ValidationType impostata su ValidationType.Schema).This setting applies to XmlReader objects that validate schemas (ValidationType property set to ValidationType.Schema).

ValidationType ValidationType ValidationType ValidationType

Ottiene o imposta un valore che indica se l'oggetto XmlReader eseguirà la convalida o l'assegnazione del tipo durante la lettura.Gets or sets a value indicating whether the XmlReader will perform validation or type assignment when reading.

XmlResolver XmlResolver XmlResolver XmlResolver

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

Metodi

Clone() Clone() Clone() Clone()

Crea una copia dell'istanza XmlReaderSettings.Creates a copy of the XmlReaderSettings instance.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
Reset() Reset() Reset() Reset()

Ripristina i valori predefiniti dei membri della classe delle impostazioni.Resets the members of the settings class to their default values.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Eventi

ValidationEventHandler ValidationEventHandler ValidationEventHandler ValidationEventHandler

Si verifica quando il lettore rileva errori di convalida.Occurs when the reader encounters validation errors.

Si applica a

Vedi anche