Exportar (0) Imprimir
Expandir todo

XmlReader.Create (Método) (Stream, XmlReaderSettings, XmlParserContext)

Crea una nueva instancia de XmlReader utilizando la secuencia y los objetos XmlReaderSettings y XmlParserContext especificados.

Espacio de nombres: System.Xml
Ensamblado: System.Xml (en system.xml.dll)

public static XmlReader Create (
	Stream input,
	XmlReaderSettings settings,
	XmlParserContext inputContext
)
public static XmlReader Create (
	Stream input, 
	XmlReaderSettings settings, 
	XmlParserContext inputContext
)
public static function Create (
	input : Stream, 
	settings : XmlReaderSettings, 
	inputContext : XmlParserContext
) : XmlReader
No aplicable.

Parámetros

input

Secuencia que contiene los datos XML.

XmlReader examina los primeros bytes de la secuencia buscando una marca de orden de bytes u otro signo de codificación. Cuando se especifica la codificación, esta se utiliza para seguir leyendo la secuencia, y el procesamiento continúa analizando la entrada como una secuencia de caracteres (Unicode).

settings

Objeto XmlReaderSettings que se utiliza para configurar la nueva instancia de XmlReader. Este valor puede ser referencia null (Nothing en Visual Basic).

inputContext

Objeto XmlParserContext que proporciona la información de contexto necesaria para analizar el fragmento XML. La información de contexto puede incluir el objeto XmlNameTable que se va a utilizar, la codificación, el ámbito del espacio de nombres, el ámbito actual de xml:lang y xml:space, el URI base y la definición de tipo de documento.

Este valor puede ser referencia null (Nothing en Visual Basic).

Valor devuelto

Objeto XmlReader para leer datos XML.

Tipo de excepciónCondición

ArgumentNullException

El valor de input es referencia null (Nothing en Visual Basic).

De forma predeterminada se utiliza un XmlUrlResolver sin credenciales para tener acceso a los recursos externos, como una definición de tipo de documento (DTD), entidades, esquemas, etc. Si el recurso externo se encuentra en un recurso de red que requiere autenticación, utilice la propiedad XmlReaderSettings.XmlResolver para especificar un XmlResolver con las credenciales necesarias.

Nota de seguridadNota: de seguridad

Puede utilizar uno de los métodos siguientes para controlar a qué recursos puede tener acceso XmlReader:

Restrinja los recursos a los que puede tener acceso XmlReader estableciendo la propiedad XmlResolver en un objeto XmlSecureResolver.

O bien

No permita que XmlReader abra ningún recurso externo estableciendo la propiedad XmlResolver en referencia null (Nothing en Visual Basic).

El objeto XmlReader creado expande las referencias de entidad y realiza la normalización XML de los nuevos caracteres de línea.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0

.NET Compact Framework

Compatible con: 2.0

XNA Framework

Compatible con: 1.0
Mostrar:
© 2014 Microsoft