XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings Class

Definición

Especifica un conjunto de características compatibles en el objeto XmlReader creado mediante el método 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
Herencia
XmlReaderSettingsXmlReaderSettingsXmlReaderSettingsXmlReaderSettings

Ejemplos

En el ejemplo siguiente se XmlReader crea un que usa con las credenciales necesarias. XmlUrlResolverThe 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)

Comentarios

Use el Create método para obtener XmlReader instancias.You use the Create method to obtain XmlReader instances. Este método usa la XmlReaderSettings clase para especificar qué características se van a implementar XmlReader en el objeto que crea.This method uses the XmlReaderSettings class to specify which features to implement in the XmlReader object it creates.

Vea las secciones comentarios de las XmlReader páginas Create de referencia de y para obtener información sobre la configuración que se va a usar para las comprobaciones de cumplimiento, la validación y otros escenarios comunes.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. Vea el XmlReaderSettings() constructor para obtener una lista de valores predeterminados.See the XmlReaderSettings() constructor for a list of default settings.

Consideraciones de seguridadSecurity considerations

Tenga en cuenta lo siguiente al XmlReaderSettings utilizar la clase.Consider the following when using the XmlReaderSettings class.

  • Las marcas de validación ProcessInlineSchema y ProcessSchemaLocation de un objeto XmlReaderSettings no están establecidos de manera predeterminada.The ProcessInlineSchema and ProcessSchemaLocation validation flags of an XmlReaderSettings object are not set by default. Cuando se establecen estas marcas, se utiliza el XmlResolver del objeto XmlReaderSettings para resolver las ubicaciones de esquemas que se encuentra en el documento de la instancia de 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. Si el XmlResolver objeto es null, las ubicaciones de esquemas no se resuelven ProcessSchemaLocation aunque se establezcan las ProcessInlineSchema marcas de validación y.If the XmlResolver object is null, schema locations are not resolved even if the ProcessInlineSchema and ProcessSchemaLocation validation flags are set.

  • Los esquemas agregados durante la validación agregan nuevos tipos y pueden cambiar el resultado de la validación del documento.Schemas added during validation add new types and can change the validation outcome of the document being validated. Como consecuencia, los esquemas externos solo se deberían resolver desde orígenes de confianza.As a result, external schemas should only be resolved from trusted sources.

  • Los mensajes de error de validación pueden exponer información confidencial del modelo de contenido.Validation error messages may expose sensitive content model information. Los mensajes de error y de advertencia de validación ValidationEventHandler se controlan mediante el delegado o XmlSchemaValidationException se exponen como si no se XmlReaderSettings proporcionase ningún controlador de eventos al objeto XmlSchemaValidationException (las advertencias de validación no hacen que se produzca una excepción).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). Esta información del modelo de contenido no se debe exponer en escenarios que no son de confianza.This content model information should not be exposed in untrusted scenarios. Los mensajes de advertencia de validación se suprimen de forma predeterminada y se ReportValidationWarnings pueden informar estableciendo la marca.Validation warning messages are suppressed by default and can be reported by setting the ReportValidationWarnings flag.

  • La SourceUri propiedadXmlSchemaValidationException de devuelve la ruta de acceso del URI al archivo de esquema que produjo la excepción.The SourceUri property of an XmlSchemaValidationException returns the URI path to the schema file that caused the exception. La SourceUri propiedad no se debe exponer en escenarios que no son de confianza.The SourceUri property should not be exposed in untrusted scenarios.

  • Se recomienda deshabilitar la ProcessIdentityConstraints marca (habilitada de forma predeterminada) al validar documentos XML grandes, que no son de confianza, en escenarios de alta disponibilidad con respecto a un esquema con restricciones de identidad en una gran parte 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.

  • Los objetos XmlReaderSettings pueden contener información confidencial como, por ejemplo, credenciales de usuario.XmlReaderSettings objects can contain sensitive information such as user credentials. Debería tener cuidado al almacenar en caché objetos XmlReaderSettings o al pasar el objeto XmlReaderSettings de un componente a otro.You should be careful when caching XmlReaderSettings objects, or when passing the XmlReaderSettings object from one component to another.

  • El procesamiento de DTD está deshabilitado de manera predeterminada.DTD processing is disabled by default. Si habilita el procesamiento de DTD, debe tener en cuenta la inclusión de DTD de orígenes que no son de confianza y posibles ataques de denegación de servicio.If you enable DTD processing, you need to be aware of including DTDs from untrusted sources and possible denial of service attacks. Utilice para restringir los recursos a los XmlReader que puede tener acceso. XmlSecureResolverUse the XmlSecureResolver to restrict the resources that the XmlReader can access.

  • No admita componentes como, por ejemplo, objetos NameTable, XmlNamespaceManager y XmlResolver, de un origen que no sea de confianza.Do not accept supporting components, such as NameTable, XmlNamespaceManager, and XmlResolver objects, from an untrusted source.

  • El uso de la memoria que hace una aplicación que utiliza el XmlReader puede tener una correlación con el tamaño del documento XML analizado.Memory usage of an application that uses XmlReader may have a correlation to the size of the parsed XML document. Una forma de provocar un ataque de denegación de servicio es enviando documentos XML excesivamente grandes para ser analizados.One form of denial of service attack is when excessively large XML documents are submitted to be parsed. Puede limitar el tamaño del documento que se puede analizar estableciendo la MaxCharactersInDocument propiedad y, a continuación, limitar el número de caracteres resultante de expandir las entidades estableciendo la MaxCharactersFromEntities propiedad.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.

Constructores

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

Inicializa una nueva instancia de la clase XmlReaderSettings.Initializes a new instance of the XmlReaderSettings class.

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

Inicializa una nueva instancia de la clase XmlReaderSettings.Initializes a new instance of the XmlReaderSettings class.

Propiedades

Async Async Async Async

Obtiene o establece si los métodos asincrónicos de XmlReader se pueden usar en una instancia determinada de XmlReader .Gets or sets whether asynchronous XmlReader methods can be used on a particular XmlReader instance.

CheckCharacters CheckCharacters CheckCharacters CheckCharacters

Obtiene o establece un valor que indica si se va a realizar la comprobación de caracteres.Gets or sets a value indicating whether to do character checking.

CloseInput CloseInput CloseInput CloseInput

Obtiene o establece un valor que indica si se debe cerrar la secuencia o el objeto TextReader subyacente al cerrar el lector.Gets or sets a value indicating whether the underlying stream or TextReader should be closed when the reader is closed.

ConformanceLevel ConformanceLevel ConformanceLevel ConformanceLevel

Obtiene o establece el nivel de conformidad que cumplirá XmlReader.Gets or sets the level of conformance which the XmlReader will comply.

DtdProcessing DtdProcessing DtdProcessing DtdProcessing

Obtiene o establece un valor que determine el procesamiento de DTD.Gets or sets a value that determines the processing of DTDs.

IgnoreComments IgnoreComments IgnoreComments IgnoreComments

Obtiene o establece un valor que indica si se van a omitir los comentarios.Gets or sets a value indicating whether to ignore comments.

IgnoreProcessingInstructions IgnoreProcessingInstructions IgnoreProcessingInstructions IgnoreProcessingInstructions

Obtiene o establece un valor que indica si se van a omitir las instrucciones de procesamiento.Gets or sets a value indicating whether to ignore processing instructions.

IgnoreWhitespace IgnoreWhitespace IgnoreWhitespace IgnoreWhitespace

Obtiene o establece un valor que indica si se va a omitir el espacio en blanco no significativo.Gets or sets a value indicating whether to ignore insignificant white space.

LineNumberOffset LineNumberOffset LineNumberOffset LineNumberOffset

Obtiene o establece el desplazamiento del número de línea del objeto XmlReader.Gets or sets line number offset of the XmlReader object.

LinePositionOffset LinePositionOffset LinePositionOffset LinePositionOffset

Obtiene o establece el desplazamiento de la posición de línea del objeto XmlReader.Gets or sets line position offset of the XmlReader object.

MaxCharactersFromEntities MaxCharactersFromEntities MaxCharactersFromEntities MaxCharactersFromEntities

Obtiene o establece un valor que indica el número máximo de caracteres permitido en un documento que resulta de expandir las entidades.Gets or sets a value indicating the maximum allowable number of characters in a document that result from expanding entities.

MaxCharactersInDocument MaxCharactersInDocument MaxCharactersInDocument MaxCharactersInDocument

Obtiene o establece un valor que indica el número máximo de caracteres permitido en un documento XML.Gets or sets a value indicating the maximum allowable number of characters in an XML document. Un valor cero (0) significa que no existe ningún límite en el tamaño del documento XML.A zero (0) value means no limits on the size of the XML document. Un valor distinto de cero especifica el tamaño máximo, en caracteres.A non-zero value specifies the maximum size, in characters.

NameTable NameTable NameTable NameTable

Obtiene o establece el objeto XmlNameTable utilizado para las comparaciones de cadenas subdivididas.Gets or sets the XmlNameTable used for atomized string comparisons.

ProhibitDtd ProhibitDtd ProhibitDtd ProhibitDtd

Obtiene o establece un valor que indica si se va a prohibir el procesamiento de la definición de tipo de documento (DTD).Gets or sets a value indicating whether to prohibit document type definition (DTD) processing. Esta propiedad ha quedado obsoleta.This property is obsolete. Utilice DtdProcessing en su lugar.Use DtdProcessing instead.

Schemas Schemas Schemas Schemas

Obtiene o establece el XmlSchemaSet que se va a utilizar al realizar la validación del esquema.Gets or sets the XmlSchemaSet to use when performing schema validation.

ValidationFlags ValidationFlags ValidationFlags ValidationFlags

Obtiene o establece un valor que indica la configuración de validación de esquemas.Gets or sets a value indicating the schema validation settings. Esta configuración se aplica a los objetos XmlReader que validan esquemas (con la propiedad ValidationType establecida en ValidationType.Schema).This setting applies to XmlReader objects that validate schemas (ValidationType property set to ValidationType.Schema).

ValidationType ValidationType ValidationType ValidationType

Obtiene o establece un valor que indica si el objeto XmlReader realizará la validación o la asignación de tipos al leer.Gets or sets a value indicating whether the XmlReader will perform validation or type assignment when reading.

XmlResolver XmlResolver XmlResolver XmlResolver

Establece el objeto XmlResolver utilizado para obtener acceso a documentos externos.Sets the XmlResolver used to access external documents.

Métodos

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

Crea una copia de la instancia de la clase XmlReaderSettings.Creates a copy of the XmlReaderSettings instance.

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

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Restablece los miembros de la clase de configuración a sus valores predeterminados.Resets the members of the settings class to their default values.

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

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Eventos

ValidationEventHandler ValidationEventHandler ValidationEventHandler ValidationEventHandler

Se produce cuando el lector encuentra errores de validación.Occurs when the reader encounters validation errors.

Se aplica a

Consulte también: