XmlReader.Create Método

Definición

Espacio de nombres:
System.Xml
Ensamblados:
netstandard.dll, System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.dll
Ensamblado:
netstandard.dll
Ensamblados:
System.Xml.dll, System.Xml.ReaderWriter.dll

Crea una nueva instancia de XmlReader.

Sobrecargas

Nombre Description
Create(String, XmlReaderSettings, XmlParserContext)

Crea una nueva XmlReader instancia mediante el URI, la configuración y la información de contexto especificadas para el análisis.
Create(TextReader, XmlReaderSettings, XmlParserContext)

Crea una nueva XmlReader instancia mediante el lector de texto, la configuración y la información de contexto especificadas para el análisis.
Create(Stream, XmlReaderSettings, XmlParserContext)

Crea una nueva XmlReader instancia mediante la secuencia, la configuración y la información de contexto especificadas para el análisis.
Create(Stream, XmlReaderSettings, String)

Crea una nueva XmlReader instancia con la secuencia, el URI base y la configuración especificados.
Create(XmlReader, XmlReaderSettings)

Crea una nueva XmlReader instancia mediante el lector XML y la configuración especificados.
Create(TextReader, XmlReaderSettings, String)

Crea una nueva XmlReader instancia mediante el lector de texto, la configuración y el URI base especificados.
Create(TextReader, XmlReaderSettings)

Crea una nueva XmlReader instancia mediante el lector de texto y la configuración especificados.
Create(Stream, XmlReaderSettings)

Crea una nueva XmlReader instancia con la secuencia y la configuración especificadas.
Create(String)

Crea una nueva XmlReader instancia con el URI especificado.
Create(TextReader)

Crea una nueva XmlReader instancia mediante el lector de texto especificado.
Create(Stream)

Crea una nueva XmlReader instancia mediante el flujo especificado con la configuración predeterminada.
Create(String, XmlReaderSettings)

Crea una nueva XmlReader instancia mediante el URI y la configuración especificados.

Ejemplos

En este ejemplo se crea un lector XML que quita espacios en blanco insignificantes, se quitan comentarios y se realiza una comprobación de conformidad de nivel de fragmento.

XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.IgnoreWhitespace = true;
settings.IgnoreComments = true;
XmlReader reader = XmlReader.Create("books.xml", settings);

Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.IgnoreWhitespace = true
settings.IgnoreComments = true
Dim reader As XmlReader = XmlReader.Create("books.xml", settings)

En el ejemplo siguiente se usa un XmlUrlResolver con credenciales predeterminadas para acceder a un archivo.

// Set the reader settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.IgnoreComments = true;
settings.IgnoreProcessingInstructions = true;
settings.IgnoreWhitespace = true;

' Set the reader settings.
Dim settings as XmlReaderSettings = new XmlReaderSettings()
settings.IgnoreComments = true
settings.IgnoreProcessingInstructions = true
settings.IgnoreWhitespace = true

// Create a resolver with default credentials.
XmlUrlResolver resolver = new XmlUrlResolver();
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials;

// Set the reader settings object to use the resolver.
settings.XmlResolver = resolver;

// Create the XmlReader object.
XmlReader reader = XmlReader.Create("http://ServerName/data/books.xml", settings);

' Create a resolver with default credentials.
Dim resolver as XmlUrlResolver = new XmlUrlResolver()
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials

' Set the reader settings object to use the resolver.
settings.XmlResolver = resolver

' Create the XmlReader object.
Dim reader as XmlReader = XmlReader.Create("http://ServerName/data/books.xml", settings)

El código siguiente encapsula una instancia de lector dentro de otro lector.

XmlTextReader txtReader = new XmlTextReader("bookOrder.xml");
XmlReaderSettings settings = new XmlReaderSettings();
settings.Schemas.Add("urn:po-schema", "PO.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader reader = XmlReader.Create(txtReader, settings);

Dim txtReader As XmlTextReader = New XmlTextReader("bookOrder.xml")
Dim settings As New XmlReaderSettings()
settings.Schemas.Add("urn:po-schema", "PO.xsd")
settings.ValidationType = ValidationType.Schema
Dim reader As XmlReader = XmlReader.Create(txtReader, settings)

En este ejemplo se obliga a los lectores a agregar la validación de esquemas XML y DTD.

XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.DTD;
XmlReader inner = XmlReader.Create("book.xml", settings); // DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader outer = XmlReader.Create(inner, settings);  // XML Schema Validation

Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.DTD
Dim inner As XmlReader = XmlReader.Create("book.xml", settings) ' DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd")
settings.ValidationType = ValidationType.Schema
Dim outer As XmlReader = XmlReader.Create(inner, settings)  ' XML Schema Validation

Comentarios

La mayoría de las Create sobrecargas incluyen un settings parámetro que acepta un XmlReaderSettings objeto . Puede usar este objeto para:

  • Especifique qué características desea admitir en el XmlReader objeto .
  • Vuelva a usar el XmlReaderSettings objeto para crear varios lectores. Puede usar la misma configuración para crear varios lectores con la misma funcionalidad. O bien, puede modificar la configuración de una XmlReaderSettings instancia y crear un nuevo lector con un conjunto diferente de características.
  • Agregue características a un lector XML existente. El Create método puede aceptar otro XmlReader objeto. El objeto subyacente XmlReader puede ser un lector definido por el usuario, un XmlTextReader objeto u otra XmlReader instancia a la que desea agregar características adicionales.
  • Saque el máximo partido a características como la comprobación de conformidad y el cumplimiento con la recomendación XML 1.0 (cuarta edición) que solo están disponibles en objetos XmlReader creados por el método estático Create.

Note

Aunque .NET incluye implementaciones concretas de la XmlReader clase , como XmlTextReader, XmlNodeReadery las XmlValidatingReader clases, se recomienda crear XmlReader instancias mediante el Create método .

Configuración predeterminada

Si usa una sobrecarga Create que no acepta un objeto XmlReaderSettings, se utiliza la siguiente configuración predeterminada del lector:

Setting Default
CheckCharacters true
ConformanceLevel ConformanceLevel.Document
IgnoreComments false
IgnoreProcessingInstructions false
IgnoreWhitespace false
LineNumberOffset 0
LinePositionOffset 0
NameTable null
DtdProcessing Prohibit
Schemas Un objeto vacío XmlSchemaSet
ValidationFlags ProcessIdentityConstraints Habilitado
ValidationType None
XmlResolver null

Configuraciones para escenarios comunes

Estas son las XmlReaderSettings propiedades que debe establecer para algunos de los escenarios típicos del lector XML.

Requirement Establecer
Los datos deben ser un documento XML bien formado. De ConformanceLevel a Document.
Los datos deben ser una entidad analizada XML bien formada. De ConformanceLevel a Fragment.
Los datos deben validarse con un DTD. DtdProcessing a Parse
De ValidationType a DTD.
Los datos deben validarse con un esquema XML. ValidationType a Schema
Schemas a la XmlSchemaSet que se va a usar para validación. Tenga en cuenta que XmlReader no admite la validación de esquemas de XML-Data reducido (XDR).
Los datos deben validarse contra un esquema XML en línea. ValidationType a Schema
De ValidationFlags a ProcessInlineSchema.
Soporte de tipos. ValidationType a Schema
Schemas al XmlSchemaSet que se va a usar.

XmlReader no admite la validación del esquema XML-Data Reduced (XDR).

Programación asincrónica

En modo sincrónico, el método Create lee el primer bloque de datos del búfer del archivo, la secuencia o el lector de texto. Esto puede producir una excepción si se produce un error en una operación de E/S. En modo asincrónico, la primera operación de E/S se produce con una operación de lectura, por lo que las excepciones que surjan se producirán cuando se produzca la operación de lectura.

Consideraciones de seguridad

De forma predeterminada, XmlReader usa un XmlUrlResolver objeto sin credenciales de usuario para abrir recursos. Esto significa que, de forma predeterminada, el lector XML puede acceder a cualquier ubicación que no requiera credenciales. Use la propiedad XmlResolver para controlar el acceso a los recursos.

  • Use ThrowingResolver para restringir los recursos a los que puede acceder el lector XML o...
  • Establézcalo XmlResolver en null para impedir que el lector XML abra recursos externos.

Create(String, XmlReaderSettings, XmlParserContext)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Crea una nueva XmlReader instancia mediante el URI, la configuración y la información de contexto especificadas para el análisis.

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);
public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);
public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);
static member Create : string * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader
Public Shared Function Create (inputUri As String, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parámetros

inputUri
String

Identificador URI del archivo que contiene los datos XML. El XmlResolver objeto del XmlReaderSettings objeto se usa para convertir la ruta de acceso a una representación de datos canónica. Si XmlResolver es null, se usa un nuevo XmlUrlResolver objeto.

settings
XmlReaderSettings

Configuración de la nueva XmlReader instancia. Este valor puede ser null.

inputContext
XmlParserContext

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

Este valor puede ser null.

Devoluciones

XmlReader

Objeto que se usa para leer los datos XML de la secuencia.

Excepciones

ArgumentNullException

El valor de inputUri es null.

SecurityException

XmlReader no tiene permisos suficientes para acceder a la ubicación de los datos XML.

ArgumentException

Las NameTable propiedades y NameTable contienen valores. (Solo se puede establecer y usar una de estas NameTable propiedades).

FileNotFoundException

No se encuentra el archivo especificado por el URI.

UriFormatException

El formato de URI no es correcto.

Comentarios

De forma predeterminada, se usa un XmlUrlResolver sin credenciales para acceder a los recursos externos, como una definición de tipo de documento (DTD), entidades, esquemas, etc.

Importante

A partir de .NET Framework 4.5.2, no se proporciona ningún valor predeterminado XmlUrlResolver . Si la solución tiene como destino .NET Framework 4.5.2 o versiones posteriores, especifique un XmlResolver mediante la XmlReaderSettings.XmlResolver propiedad .

Esto significa que XmlReader puede acceder a cualquier ubicación que no requiera autenticación. Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la XmlReaderSettings.XmlResolver propiedad para especificar un XmlResolver con las credenciales necesarias.

Importante

Puede restringir los recursos a los que XmlReader puede acceder mediante ThrowingResolver.

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

Se aplica a

Create(TextReader, XmlReaderSettings, XmlParserContext)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Crea una nueva XmlReader instancia mediante el lector de texto, la configuración y la información de contexto especificadas para el análisis.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);
public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);
public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);
static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader
Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parámetros

input
TextReader

Lector de texto desde el que se van a leer los datos XML. Un lector de texto devuelve una secuencia de caracteres Unicode, por lo que el lector XML no usa la codificación especificada en la declaración XML para descodificar el flujo de datos.

settings
XmlReaderSettings

Configuración de la nueva XmlReader instancia. Este valor puede ser null.

inputContext
XmlParserContext

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

Este valor puede ser null.

Devoluciones

XmlReader

Objeto que se usa para leer los datos XML de la secuencia.

Excepciones

ArgumentNullException

El valor de input es null.

ArgumentException

Las NameTable propiedades y NameTable contienen valores. (Solo se puede establecer y usar una de estas NameTable propiedades).

Ejemplos

En el ejemplo siguiente se crea un XmlReader objeto que lee un fragmento XML.

string xmlFrag ="<item rk:ID='abc-23'>hammer</item> " +
                        "<item rk:ID='r2-435'>paint</item>" +
                        "<item rk:ID='abc-39'>saw</item>";

// Create the XmlNamespaceManager.
NameTable nt = new NameTable();
XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
nsmgr.AddNamespace("rk", "urn:store-items");

// Create the XmlParserContext.
XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.None);

// Create the reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
XmlReader reader = XmlReader.Create(new StringReader(xmlFrag), settings, context);

Dim xmlFrag As String = "<item rk:ID='abc-23'>hammer</item> " & _
                                     "<item rk:ID='r2-435'>paint</item>" & _
                                     "<item rk:ID='abc-39'>saw</item>"

' Create the XmlNamespaceManager.
Dim nt As New NameTable()
Dim nsmgr As New XmlNamespaceManager(nt)
nsmgr.AddNamespace("rk", "urn:store-items")

' Create the XmlParserContext.
Dim context As New XmlParserContext(Nothing, nsmgr, Nothing, XmlSpace.None)

' Create the reader. 
Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlFrag), settings, context)

Comentarios

De forma predeterminada, se usa un XmlUrlResolver sin credenciales para acceder a los recursos externos, como una definición de tipo de documento (DTD), entidades, esquemas, etc.

Importante

A partir de .NET Framework 4.5.2, no se proporciona ningún valor predeterminado XmlUrlResolver . Si la solución tiene como destino .NET Framework 4.5.2 o versiones posteriores, especifique un XmlResolver mediante la XmlReaderSettings.XmlResolver propiedad .

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la XmlReaderSettings.XmlResolver propiedad para especificar un XmlResolver con las credenciales necesarias.

Importante

Puede usar uno de los métodos siguientes para controlar los recursos a los XmlReader que puede acceder:

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

Se aplica a

Create(Stream, XmlReaderSettings, XmlParserContext)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Crea una nueva XmlReader instancia mediante la secuencia, la configuración y la información de contexto especificadas para el análisis.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);
public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);
public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);
static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader
Public Shared Function Create (input As Stream, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parámetros

input
Stream

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 determina la codificación, la codificación se usa para continuar leyendo la secuencia y el procesamiento continúa a analizar la entrada como una secuencia de caracteres (Unicode).

settings
XmlReaderSettings

Configuración de la nueva XmlReader instancia. Este valor puede ser null.

inputContext
XmlParserContext

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

Este valor puede ser null.

Devoluciones

XmlReader

Objeto que se usa para leer los datos XML de la secuencia.

Excepciones

ArgumentNullException

El valor de input es null.

Comentarios

De forma predeterminada, se usa un XmlUrlResolver sin credenciales para acceder a los recursos externos, como una definición de tipo de documento (DTD), entidades, esquemas, etc.

Importante

A partir de .NET Framework 4.5.2, no se proporciona ningún valor predeterminado XmlUrlResolver . Si la solución tiene como destino .NET Framework 4.5.2 o versiones posteriores, especifique un XmlResolver mediante la XmlReaderSettings.XmlResolver propiedad .

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la XmlReaderSettings.XmlResolver propiedad para especificar un XmlResolver con las credenciales necesarias.

Importante

Puede usar uno de los métodos siguientes para controlar los recursos a los XmlReader que puede acceder:

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

Se aplica a

Create(Stream, XmlReaderSettings, String)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Crea una nueva XmlReader instancia con la secuencia, el URI base y la configuración especificados.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings, System::String ^ baseUri);
public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings? settings, string? baseUri);
public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings settings, string baseUri);
static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader
Public Shared Function Create (input As Stream, settings As XmlReaderSettings, baseUri As String) As XmlReader

Parámetros

input
Stream

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 determina la codificación, la codificación se usa para continuar leyendo la secuencia y el procesamiento continúa a analizar la entrada como una secuencia de caracteres (Unicode).

settings
XmlReaderSettings

Configuración de la nueva XmlReader instancia. Este valor puede ser null.

baseUri
String

URI base para la entidad o documento que se está leyendo. Este valor puede ser null.

Nota de seguridad El URI base se usa para resolver el URI relativo del documento XML. No use un URI base de un origen que no sea de confianza.

Devoluciones

XmlReader

Objeto que se usa para leer los datos XML de la secuencia.

Excepciones

ArgumentNullException

El valor de input es null.

Comentarios

De forma predeterminada, se usa un XmlUrlResolver sin credenciales para acceder a los recursos externos, como una definición de tipo de documento (DTD), entidades, esquemas, etc.

Importante

A partir de .NET Framework 4.5.2, no se proporciona ningún valor predeterminado XmlUrlResolver . Si la solución tiene como destino .NET Framework 4.5.2 o versiones posteriores, especifique un XmlResolver mediante la XmlReaderSettings.XmlResolver propiedad .

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la XmlReaderSettings.XmlResolver propiedad para especificar un XmlResolver con las credenciales necesarias.

Importante

Puede usar uno de los métodos siguientes para controlar los recursos a los XmlReader que puede acceder:

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

Se aplica a

Create(XmlReader, XmlReaderSettings)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Crea una nueva XmlReader instancia mediante el lector XML y la configuración especificados.

public:
 static System::Xml::XmlReader ^ Create(System::Xml::XmlReader ^ reader, System::Xml::XmlReaderSettings ^ settings);
public static System.Xml.XmlReader Create(System.Xml.XmlReader reader, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create(System.Xml.XmlReader reader, System.Xml.XmlReaderSettings? settings);
static member Create : System.Xml.XmlReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (reader As XmlReader, settings As XmlReaderSettings) As XmlReader

Parámetros

reader
XmlReader

Objeto que desea usar como lector XML subyacente.

settings
XmlReaderSettings

Configuración de la nueva XmlReader instancia.

El nivel de conformidad del XmlReaderSettings objeto debe coincidir con el nivel de conformidad del lector subyacente, o bien debe establecerse en Auto.

Devoluciones

XmlReader

Objeto que se ajusta alrededor del objeto especificado XmlReader .

Excepciones

ArgumentNullException

El valor de reader es null.

InvalidOperationException

Si el XmlReaderSettings objeto especifica un nivel de conformidad que no es coherente con el nivel de conformidad del lector subyacente.

O bien

El subyacente XmlReader está en un Error estado o Closed .

Ejemplos

En el ejemplo siguiente se crea un objeto de validación XmlReader que se ajusta alrededor de un XmlNodeReader objeto .

// Create the XmlNodeReader object.
XmlDocument doc = new XmlDocument();
doc.Load("books.xml");
XmlNodeReader nodeReader = new XmlNodeReader(doc);

// Set the validation settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.Schema;
settings.Schemas.Add("urn:bookstore-schema", "books.xsd");
settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

// Create a validating reader that wraps the XmlNodeReader object.
XmlReader reader = XmlReader.Create(nodeReader, settings);
// Parse the XML file.
while (reader.Read());

' Create the XmlNodeReader object.
Dim doc As New XmlDocument()
doc.Load("books.xml")
Dim nodeReader As New XmlNodeReader(doc)

' Set the validation settings.
Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.Schema
settings.Schemas.Add("urn:bookstore-schema", "books.xsd")
AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

' Create a validating reader that wraps the XmlNodeReader object.
Dim reader As XmlReader = XmlReader.Create(nodeReader, settings)
' Parse the XML file.
While reader.Read()
End While

Comentarios

Este método permite agregar características adicionales a un objeto subyacente XmlReader . El objeto subyacente XmlReader puede ser otro XmlReader objeto creado por el Create método o un XmlReader objeto creado mediante una de las implementaciones concretas XmlReader .

Se usa un valor predeterminado XmlUrlResolver sin credenciales para acceder a ningún recurso externo, como un esquema.

Importante

A partir de .NET Framework 4.5.2, no se proporciona ningún valor predeterminado XmlUrlResolver . Si la solución tiene como destino .NET Framework 4.5.2 o versiones posteriores, especifique un XmlResolver mediante la XmlReaderSettings.XmlResolver propiedad .

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, especifique una XmlResolver con las credenciales necesarias mediante la XmlReaderSettings.XmlResolver propiedad .

Importante

Puede usar uno de los métodos siguientes para controlar los recursos a los XmlReader que puede acceder:

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

Se aplica a

Create(TextReader, XmlReaderSettings, String)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Crea una nueva XmlReader instancia mediante el lector de texto, la configuración y el URI base especificados.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings, System::String ^ baseUri);
public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, string? baseUri);
public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings settings, string baseUri);
static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader
Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, baseUri As String) As XmlReader

Parámetros

input
TextReader

Lector de texto desde el que se van a leer los datos XML. Un lector de texto devuelve una secuencia de caracteres Unicode, por lo que la codificación especificada en la declaración XML no la usa XmlReader para descodificar el flujo de datos.

settings
XmlReaderSettings

Configuración de la nueva XmlReader instancia. Este valor puede ser null.

baseUri
String

URI base para la entidad o documento que se está leyendo. Este valor puede ser null.

Nota de seguridad El URI base se usa para resolver el URI relativo del documento XML. No use un URI base de un origen que no sea de confianza.

Devoluciones

XmlReader

Objeto que se usa para leer los datos XML de la secuencia.

Excepciones

ArgumentNullException

El valor de input es null.

Comentarios

De forma predeterminada, se usa un XmlUrlResolver sin credenciales para acceder a los recursos externos, como una definición de tipo de documento (DTD), entidades, esquemas, etc.

Importante

A partir de .NET Framework 4.5.2, no se proporciona ningún valor predeterminado XmlUrlResolver . Si la solución tiene como destino .NET Framework 4.5.2 o versiones posteriores, especifique un XmlResolver mediante la XmlReaderSettings.XmlResolver propiedad .

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la XmlReaderSettings.XmlResolver propiedad para especificar un XmlResolver con las credenciales necesarias.

Importante

Puede usar uno de los métodos siguientes para controlar los recursos a los XmlReader que puede acceder:

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

Se aplica a

Create(TextReader, XmlReaderSettings)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Crea una nueva XmlReader instancia mediante el lector de texto y la configuración especificados.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings);
public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings? settings);
static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (input As TextReader, settings As XmlReaderSettings) As XmlReader

Parámetros

input
TextReader

Lector de texto desde el que se van a leer los datos XML. Un lector de texto devuelve una secuencia de caracteres Unicode, por lo que el lector XML no usa la codificación especificada en la declaración XML para descodificar el flujo de datos.

settings
XmlReaderSettings

La configuración del nuevo XmlReader. Este valor puede ser null.

Devoluciones

XmlReader

Objeto que se usa para leer los datos XML de la secuencia.

Excepciones

ArgumentNullException

El valor de input es null.

Comentarios

De forma predeterminada, se usa un XmlUrlResolver sin credenciales para acceder a los recursos externos, como una definición de tipo de documento (DTD), entidades, esquemas, etc.

Importante

A partir de .NET Framework 4.5.2, no se proporciona ningún valor predeterminado XmlUrlResolver . Si la solución tiene como destino .NET Framework 4.5.2 o versiones posteriores, especifique un XmlResolver mediante la XmlReaderSettings.XmlResolver propiedad .

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la XmlReaderSettings.XmlResolver propiedad para especificar un XmlResolver con las credenciales necesarias.

Importante

Puede usar uno de los métodos siguientes para controlar los recursos a los XmlReader que puede acceder:

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

Se aplica a

Create(Stream, XmlReaderSettings)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Crea una nueva XmlReader instancia con la secuencia y la configuración especificadas.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings);
public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings? settings);
static member Create : System.IO.Stream * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (input As Stream, settings As XmlReaderSettings) As XmlReader

Parámetros

input
Stream

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 determina la codificación, la codificación se usa para continuar leyendo la secuencia y el procesamiento continúa a analizar la entrada como una secuencia de caracteres (Unicode).

settings
XmlReaderSettings

Configuración de la nueva XmlReader instancia. Este valor puede ser null.

Devoluciones

XmlReader

Objeto que se usa para leer los datos XML de la secuencia.

Excepciones

ArgumentNullException

El valor de input es null.

Comentarios

De forma predeterminada, se usa un XmlUrlResolver sin credenciales para acceder a los recursos externos, como una definición de tipo de documento (DTD), entidades, esquemas, etc.

Importante

A partir de .NET Framework 4.5.2, no se proporciona ningún valor predeterminado XmlUrlResolver . Si la solución tiene como destino .NET Framework 4.5.2 o versiones posteriores, especifique un XmlResolver mediante la XmlReaderSettings.XmlResolver propiedad .

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la XmlReaderSettings.XmlResolver propiedad para especificar un XmlResolver con las credenciales necesarias.

Importante

Puede usar uno de los métodos siguientes para controlar los recursos a los XmlReader que puede acceder:

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

Se aplica a

Create(String)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Crea una nueva XmlReader instancia con el URI especificado.

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri);
public static System.Xml.XmlReader Create(string inputUri);
static member Create : string -> System.Xml.XmlReader
Public Shared Function Create (inputUri As String) As XmlReader

Parámetros

inputUri
String

Identificador URI del archivo que contiene los datos XML. La XmlUrlResolver clase se usa para convertir la ruta de acceso a una representación de datos canónica.

Devoluciones

XmlReader

Objeto que se usa para leer los datos XML de la secuencia.

Excepciones

ArgumentNullException

El valor de inputUri es null.

SecurityException

XmlReader no tiene permisos suficientes para acceder a la ubicación de los datos XML.

FileNotFoundException

El archivo identificado por el URI no existe.

UriFormatException

El formato de URI no es correcto.

Nota: En .NET para aplicaciones de Windows Store o la biblioteca de clases Portable, captura la excepción de clase base, FormatException, en su lugar.

Ejemplos

En el ejemplo siguiente se crea un XmlReader objeto que lee el archivo de datos XML especificado por el URI.

// Create the XmlReader object.
XmlReader reader = XmlReader.Create("books.xml");

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create("books.xml")

Comentarios

Se usa un XmlReaderSettings objeto con la configuración predeterminada para crear el lector. Si desea especificar las características compatibles con el lector creado, use la sobrecarga que toma un XmlReaderSettings objeto como uno de sus argumentos y pase un XmlReaderSettings objeto con la configuración correcta.

Un valor predeterminado XmlUrlResolver sin credenciales se usa para acceder a ningún recurso externo, como una definición de tipo de documento (DTD), entidades, esquemas, etc.

Importante

A partir de .NET Framework 4.5.2, no se proporciona ningún valor predeterminado XmlUrlResolver . Si la solución tiene como destino .NET Framework 4.5.2 o versiones posteriores, especifique un XmlResolver mediante la XmlReaderSettings.XmlResolver propiedad .

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, especifique una XmlResolver con las credenciales necesarias mediante la XmlReaderSettings.XmlResolver propiedad .

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

Se aplica a

Create(TextReader)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Crea una nueva XmlReader instancia mediante el lector de texto especificado.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input);
public static System.Xml.XmlReader Create(System.IO.TextReader input);
static member Create : System.IO.TextReader -> System.Xml.XmlReader
Public Shared Function Create (input As TextReader) As XmlReader

Parámetros

input
TextReader

Lector de texto desde el que se van a leer los datos XML. Un lector de texto devuelve una secuencia de caracteres Unicode, por lo que el lector XML no usa la codificación especificada en la declaración XML para descodificar el flujo de datos.

Devoluciones

XmlReader

Objeto que se usa para leer los datos XML de la secuencia.

Excepciones

ArgumentNullException

El valor de input es null.

Ejemplos

En el ejemplo siguiente se usa la StringReader clase para leer una cadena XML.

string xmlData ="<item productID='124390'>" +
                        "<price>5.95</price>" +
                        "</item>";

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(new StringReader(xmlData));

Dim xmlData As String = "<item productID='124390'>" & _ 
                                     "<price>5.95</price>" & _ 
                                     "</item>"

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlData))

Comentarios

Se usa un XmlReaderSettings objeto con la configuración predeterminada para crear el lector. Si desea especificar las características compatibles con el lector creado, use la sobrecarga que toma un XmlReaderSettings objeto como uno de sus argumentos y pase un XmlReaderSettings objeto con la configuración correcta.

Un valor predeterminado XmlUrlResolver sin credenciales se usa para acceder a ningún recurso externo, como una definición de tipo de documento (DTD), entidades, esquemas, etc.

Importante

A partir de .NET Framework 4.5.2, no se proporciona ningún valor predeterminado XmlUrlResolver . Si la solución tiene como destino .NET Framework 4.5.2 o versiones posteriores, especifique un XmlResolver mediante la XmlReaderSettings.XmlResolver propiedad .

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, especifique una XmlResolver con las credenciales necesarias mediante la XmlReaderSettings.XmlResolver propiedad .

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

Se aplica a

Create(Stream)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Crea una nueva XmlReader instancia mediante el flujo especificado con la configuración predeterminada.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input);
public static System.Xml.XmlReader Create(System.IO.Stream input);
static member Create : System.IO.Stream -> System.Xml.XmlReader
Public Shared Function Create (input As Stream) As XmlReader

Parámetros

input
Stream

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 determina la codificación, la codificación se usa para continuar leyendo la secuencia y el procesamiento continúa a analizar la entrada como una secuencia de caracteres (Unicode).

Devoluciones

XmlReader

Objeto que se usa para leer los datos XML de la secuencia.

Excepciones

ArgumentNullException

El valor de input es null.

SecurityException

XmlReader no tiene permisos suficientes para acceder a la ubicación de los datos XML.

Ejemplos

En el ejemplo siguiente se crea un XmlReader objeto que lee de un FileStreamobjeto .


FileStream fs = new FileStream(@"C:\data\books.xml", FileMode.OpenOrCreate,
                                                                    FileAccess.Read, FileShare.Read);

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(fs);

    Dim fs As New FileStream("C:\data\books.xml", FileMode.OpenOrCreate, FileAccess.Read, FileShare.Read)
    
    ' Create the XmlReader object.
    Dim reader As XmlReader = XmlReader.Create(fs)

End Sub

Comentarios

Se usa un XmlReaderSettings objeto con la configuración predeterminada para crear el lector. Si desea especificar las características compatibles con el lector creado, use la sobrecarga que toma un XmlReaderSettings objeto como uno de sus argumentos y pase un XmlReaderSettings objeto con la configuración correcta.

Un valor predeterminado XmlUrlResolver sin credenciales se usa para acceder a ningún recurso externo, como una definición de tipo de documento (DTD), entidades, esquemas, etc.

Importante

A partir de .NET Framework 4.5.2, no se proporciona ningún valor predeterminado XmlUrlResolver . Si la solución tiene como destino .NET Framework 4.5.2 o versiones posteriores, especifique un XmlResolver mediante la XmlReaderSettings.XmlResolver propiedad .

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, especifique una XmlResolver con las credenciales necesarias mediante la XmlReaderSettings.XmlResolver propiedad .

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

Se aplica a

Create(String, XmlReaderSettings)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Crea una nueva XmlReader instancia mediante el URI y la configuración especificados.

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri, System::Xml::XmlReaderSettings ^ settings);
public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings? settings);
static member Create : string * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (inputUri As String, settings As XmlReaderSettings) As XmlReader

Parámetros

inputUri
String

Identificador URI del archivo que contiene los datos XML. El XmlResolver objeto del XmlReaderSettings objeto se usa para convertir la ruta de acceso a una representación de datos canónica. Si XmlResolver es null, se usa un nuevo XmlUrlResolver objeto.

settings
XmlReaderSettings

Configuración de la nueva XmlReader instancia. Este valor puede ser null.

Devoluciones

XmlReader

Objeto que se usa para leer los datos XML de la secuencia.

Excepciones

ArgumentNullException

El valor de inputUri es null.

FileNotFoundException

No se encuentra el archivo especificado por el URI.

UriFormatException

El formato de URI no es correcto.

Nota: En .NET para aplicaciones de Windows Store o la biblioteca de clases Portable, captura la excepción de clase base, FormatException, en su lugar.

Ejemplos

En el ejemplo siguiente se crea un XmlReader objeto que admite la validación de la definición de tipo de documento (DTD).

// Set the validation settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.DtdProcessing = DtdProcessing.Parse;
settings.ValidationType = ValidationType.DTD;
settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

 // Create the XmlReader object.
XmlReader reader = XmlReader.Create("itemDTD.xml", settings);

// Parse the file.
while (reader.Read()) {}

' Set the validation settings.
Dim settings As New XmlReaderSettings()
settings.DtdProcessing = DtdProcessing.Parse
settings.ValidationType = ValidationType.DTD
AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create("itemDTD.xml", settings)

' Parse the file. 
While reader.Read()
End While

Comentarios

De forma predeterminada, se usa un XmlUrlResolver sin credenciales para acceder a los recursos externos, como una definición de tipo de documento (DTD), entidades, esquemas, etc.

Importante

A partir de .NET Framework 4.5.2, no se proporciona ningún valor predeterminado XmlUrlResolver . Si la solución tiene como destino .NET Framework 4.5.2 o versiones posteriores, especifique un XmlResolver mediante la XmlReaderSettings.XmlResolver propiedad .

Esto significa que XmlReader puede acceder a cualquier ubicación que no requiera autenticación. Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la XmlReaderSettings.XmlResolver propiedad para especificar un XmlResolver con las credenciales necesarias.

Importante

Puede restringir los recursos a los que XmlReader puede acceder mediante ThrowingResolver.

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

Se aplica a