XmlReader.Create XmlReader.Create XmlReader.Create XmlReader.Create Method

Definición

Crea una nueva instancia de XmlReader.Creates a new XmlReader instance.

Sobrecargas

Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext)

Crea una nueva instancia de XmlReader usando el URI, la configuración y la información de contexto especificados.Creates a new XmlReader instance by using the specified URI, settings, and context information for parsing.

Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext)

Crea una nueva instancia de XmlReader con el lector de texto, la configuración y la información de contexto especificados para el análisis.Creates a new XmlReader instance by using the specified text reader, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext)

Crea una nueva instancia XmlReader con el flujo, la configuración y la información de contexto especificados para el análisis.Creates a new XmlReader instance using the specified stream, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String)

Crea una nueva instancia de XmlReader usando el flujo, el URI base y la configuración especificados.Creates a new XmlReader instance using the specified stream, base URI, and settings.

Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings)

Crea una nueva instancia de XmlReader con el lector XML y la configuración especificados.Creates a new XmlReader instance by using the specified XML reader and settings.

Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String)

Crea una nueva instancia de XmlReader mediante el lector de texto, la configuración y el URI base especificados.Creates a new XmlReader instance by using the specified text reader, settings, and base URI.

Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings)

Crea una nueva instancia XmlReader usando el lector de texto y la configuración especificados.Creates a new XmlReader instance by using the specified text reader and settings.

Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings)

Crea una nueva instancia de XmlReader con el flujo y la configuración especificados.Creates a new XmlReader instance with the specified stream and settings.

Create(String) Create(String) Create(String) Create(String)

Crea una nueva instancia de XmlReader con el URI especificado.Creates a new XmlReader instance with specified URI.

Create(TextReader) Create(TextReader) Create(TextReader) Create(TextReader)

Crea una nueva instancia de XmlReader mediante el lector de texto especificado.Creates a new XmlReader instance by using the specified text reader.

Create(Stream) Create(Stream) Create(Stream) Create(Stream)

Crea una nueva instancia XmlReader mediante el flujo especificado con la configuración predeterminada.Creates a new XmlReader instance using the specified stream with default settings.

Create(String, XmlReaderSettings) Create(String, XmlReaderSettings) Create(String, XmlReaderSettings) Create(String, XmlReaderSettings)

Crea una nueva instancia de XmlReader usando el URI y la configuración especificados.Creates a new XmlReader instance by using the specified URI and settings.

Ejemplos

En este ejemplo se crea un lector XML que elimina los espacios en blanco insignificantes, elimina los comentarios y realiza la comprobación de conformidad de nivel de fragmento.This example creates an XML reader that strips insignificant white space, strips comments, and performs fragment-level conformance checking.

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 XmlUrlResolver usa con credenciales predeterminadas para obtener acceso a un archivo.The following example uses an XmlUrlResolver with default credentials to access a file.

// Set the reader settings.
XmlReaderSettings^ settings = gcnew XmlReaderSettings;
settings->IgnoreComments = true;
settings->IgnoreProcessingInstructions = true;
settings->IgnoreWhitespace = true;

// 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 = gcnew 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( L"http://ServerName/data/books.xml", settings );

// 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)

En el código siguiente se incluye una instancia de lector dentro de otro lector.The following code wraps a reader instance within another reader.

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 encadena lectores para agregar DTD y la validación de esquemas XML.This example chains readers to add DTD and XML schema validation.

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 Create las sobrecargas incluyen settings un parámetro que acepta XmlReaderSettings un objeto.Most of the Create overloads include a settings parameter that accepts an XmlReaderSettings object. Puede utilizar este objeto para:You can use this object to:

  • Especifique las características que desea que se admitan en el XmlReader objeto.Specify which features you want supported on the XmlReader object.

  • Reutilice XmlReaderSettings el objeto para crear varios lectores.Reuse the XmlReaderSettings object to create multiple readers. Puede utilizar los mismos valores para crear varios sistemas de lectura con la misma funcionalidad.You can use the same settings to create multiple readers with the same functionality. O bien, puede modificar la configuración en una XmlReaderSettings instancia de y crear un nuevo lector con un conjunto de características diferente.Or, you can modify the settings on an XmlReaderSettings instance and create a new reader with a different set of features.

  • Agregar características a un lector XML existente.Add features to an existing XML reader. El método Create puede aceptar otro objeto XmlReader.The Create method can accept another XmlReader object. El objeto XmlReader subyacente puede ser un lector definido por el usuario, XmlTextReader un objeto u otra XmlReader instancia a la que desea agregar características adicionales.The underlying XmlReader object can be a user-defined reader, a XmlTextReader object, or another XmlReader instance that you want to add additional features to.

  • Aproveche al máximo las características, como la mejora de la comprobación de conformidad y el cumplimiento de la recomendación de XML 1,0 (cuarta edición) que XmlReader solo están disponibles en objetos Create creados por el método estático.Take full advantage of features such as better conformance checking and compliance to the XML 1.0 (fourth edition) recommendation that are available only on XmlReader objects created by the static Create method.

Nota

Aunque el .NET Framework incluye implementaciones concretas de la XmlReader clase, XmlTextReadercomo, XmlNodeReadery las XmlValidatingReader clases, recomendamos que cree XmlReader instancias mediante el Create forma.Although the .NET Framework includes concrete implementations of the XmlReader class, such as the XmlTextReader, XmlNodeReader, and the XmlValidatingReader classes, we recommend that you create XmlReader instances by using the Create method.

Configuración predeterminadaDefault settings

Si utiliza una Create sobrecarga que no acepta un XmlReaderSettings objeto, se usa la siguiente configuración predeterminada del lector:If you use a Create overload that doesn't accept a XmlReaderSettings object, the following default reader settings are used:

ParámetroSetting DefaultDefault
CheckCharacters true
ConformanceLevel ConformanceLevel.Document
IgnoreComments false
IgnoreProcessingInstructions false
IgnoreWhitespace false
LineNumberOffset 00
LinePositionOffset 00
NameTable null
DtdProcessing Prohibit
Schemas Un objeto XmlSchemaSet vacíoAn empty XmlSchemaSet object
ValidationFlags ProcessIdentityConstraintsactivóProcessIdentityConstraints enabled
ValidationType None
XmlResolver Un nuevo objeto XmlUrlResolver.A new XmlUrlResolver object. A partir de la .NET Framework 4.5.2, este valor de configuración tiene un nullvalor predeterminado de.Starting with the .NET Framework 4.5.2, this setting has a default value of null.

Configuración para escenarios comunesSettings for common scenarios

Estas son las XmlReaderSettings propiedades que debe establecer para algunos de los escenarios típicos de lector XML.Here are the XmlReaderSettings properties you should set for some of the typical XML reader scenarios.

RequisitoRequirement SetSet
Los datos deben ser un documento XML con formato correcto.Data must be a well-formed XML document. ConformanceLevela Document.ConformanceLevel to Document.
Los datos deben ser una entidad analizada de XML con formato correcto.Data must be a well-formed XML parsed entity. ConformanceLevela Fragment.ConformanceLevel to Fragment.
Los datos deben validarse con una DTD.Data must be validated against a DTD. DtdProcessing a ParseDtdProcessing to Parse
ValidationTypea DTD.ValidationType to DTD.
Los datos se deben validar con respecto a un esquema XML.Data must be validated against an XML schema. ValidationType a SchemaValidationType to Schema
Schemasal que XmlSchemaSet se va a utilizar para la validación.Schemas to the XmlSchemaSet to use for validation. Tenga en XmlReader cuenta que no admite la validación de esquemas reducidos de datos XML (XDR).Note that XmlReader doesn't support XML-Data Reduced (XDR) schema validation.
Los datos se deben validar con respecto a un esquema XML en línea.Data must be validated against an inline XML schema. ValidationType a SchemaValidationType to Schema
ValidationFlagsa ProcessInlineSchema.ValidationFlags to ProcessInlineSchema.
Compatibilidad de tipos.Type support. ValidationType a SchemaValidationType to Schema
Schemasen el XmlSchemaSet que se va a usar.Schemas to the XmlSchemaSet to use.

XmlReaderno admite la validación de esquemas reducidos de datos XML (XDR).XmlReader doesn't support XML-Data Reduced (XDR) schema validation.

Programación asincrónicaAsynchronous programming

En el modo sincrónico, el Create método lee el primer fragmento de datos del búfer del archivo, la secuencia o el lector de texto.In synchronous mode, the Create method reads the first chunk of data from the buffer of the file, stream, or text reader. Esto puede producir una excepción si se produce un error en una operación de e/s.This may throw an exception if an I/O operation fails. En el modo asincrónico, la primera operación de e/s se produce con una operación de lectura, por lo que las excepciones que surgen se producirán cuando se produzca la operación de lectura.In asynchronous mode, the first I/O operation occurs with a read operation, so exceptions that arise will be thrown when the read operation occurs.

Consideraciones de seguridadSecurity considerations

De forma predeterminada, XmlReader usa un XmlUrlResolver objeto sin credenciales de usuario para abrir recursos.By default, the XmlReader uses an XmlUrlResolver object with no user credentials to open resources. Esto significa que, de forma predeterminada, el lector XML puede tener acceso a cualquier ubicación que no requiera credenciales.This means that, by default, the XML reader can access any location that doesn't require credentials. Use la XmlResolver propiedad para controlar el acceso a los recursos:Use the XmlResolver property to control access to resources:

O bien-or-

  • Establezca XmlResolver ennull para evitar que el lector XML Abra los recursos externos.Set XmlResolver to null to prevent the XML reader from opening any external resources.

Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext)

Crea una nueva instancia de XmlReader usando el URI, la configuración y la información de contexto especificados.Creates a new XmlReader instance by using the specified URI, settings, and context information for parsing.

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);
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 String String String

URI del archivo que contiene los datos XML.The URI for the file containing the XML data. El objeto XmlResolver del objeto XmlReaderSettings se utiliza para convertir la ruta de acceso en una representación de datos canónicos.The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. Si XmlResolver es null, se utiliza un nuevo objeto XmlUrlResolver.If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Configuración de la nueva instancia XmlReader.The settings for the new XmlReader instance. Este valor puede ser null.This value can be null.

inputContext
XmlParserContext XmlParserContext XmlParserContext XmlParserContext

Información de contexto necesaria para analizar el fragmento XML.The context information required to parse the XML fragment. La información de contexto puede incluir la XmlNameTable que se va a usar, 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.The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

Este valor puede ser null.This value can be null.

Devoluciones

Objeto usado para leer los datos XML del flujo.An object that is used to read the XML data in the stream.

Excepciones

El valor inputUri es null.The inputUri value is null.

XmlReader no tiene permisos suficientes para acceder a la ubicación de los datos XML.The XmlReader does not have sufficient permissions to access the location of the XML data.

Tanto la propiedad NameTable como la propiedad NameTable contienen valores.The NameTable and NameTable properties both contain values. (Solo se puede establecer y usar una de estas propiedades NameTable).(Only one of these NameTable properties can be set and used).

No se encuentra el archivo especificado por el URI.The file specified by the URI cannot be found.

El formato del URI no es correcto.The URI format is not correct.

Comentarios

De forma predeterminada XmlUrlResolver , se utiliza una sin credenciales para tener acceso a recursos externos como una definición de tipo de documento (DTD), entidades, esquemas, etc.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partir de la .NET Framework 4.5.2, no XmlUrlResolver se proporciona ningún valor predeterminado.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Si la solución tiene como destino la .NET Framework 4.5.2 o versiones posteriores, XmlResolver especifique con XmlReaderSettings.XmlResolver la propiedad.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Esto significa que XmlReader puede tener acceso a cualquier ubicación que no requiera autenticación.This means that the XmlReader can access any locations that does not require authentication. Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use XmlReaderSettings.XmlResolver la propiedad para especificar XmlResolver un con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

Puede restringir los recursos a los XmlReader que puede tener acceso estableciendo XmlResolver la propiedad en XmlSecureResolver un objeto.You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

El objeto XmlReader creado expande las referencias de entidad y realiza la normalización XML de los caracteres de nueva línea.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext)

Crea una nueva instancia de XmlReader con el lector de texto, la configuración y la información de contexto especificados para el análisis.Creates a new XmlReader instance by using the specified text reader, settings, and context information for parsing.

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 TextReader TextReader TextReader

Lector de texto desde el que se leen los datos XML.The text reader from which to read the XML data. Un lector de texto devuelve un flujo 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.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XML reader to decode the data stream.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Configuración de la nueva instancia XmlReader.The settings for the new XmlReader instance. Este valor puede ser null.This value can be null.

inputContext
XmlParserContext XmlParserContext XmlParserContext XmlParserContext

Información de contexto necesaria para analizar el fragmento XML.The context information required to parse the XML fragment. La información de contexto puede incluir la XmlNameTable que se va a usar, 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.The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

Este valor puede ser null.This value can be null.

Devoluciones

Objeto usado para leer los datos XML del flujo.An object that is used to read the XML data in the stream.

Excepciones

Tanto la propiedad NameTable como la propiedad NameTable contienen valores.The NameTable and NameTable properties both contain values. (Solo se puede establecer y usar una de estas propiedades NameTable).(Only one of these NameTable properties can be set and used).

Ejemplos

En el ejemplo siguiente se XmlReader crea un objeto que lee un fragmento XML.The following example creates an XmlReader object that reads an XML fragment.

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 XmlUrlResolver , se utiliza una sin credenciales para tener acceso a recursos externos como una definición de tipo de documento (DTD), entidades, esquemas, etc.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partir de la .NET Framework 4.5.2, no XmlUrlResolver se proporciona ningún valor predeterminado.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Si la solución tiene como destino la .NET Framework 4.5.2 o versiones posteriores, XmlResolver especifique con XmlReaderSettings.XmlResolver la propiedad.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use XmlReaderSettings.XmlResolver la propiedad para especificar XmlResolver un con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

Puede usar uno de los métodos siguientes para controlar los recursos a los XmlReader que puede tener acceso:You can use one of the following methods to control which resources the XmlReader can access:

o bien-or-

  • No permita que XmlReader abra ningún recurso externo estableciendo la propiedad XmlResolver en null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

El objeto XmlReader creado expande las referencias de entidad y realiza la normalización XML de los caracteres de nueva línea.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext)

Crea una nueva instancia XmlReader con el flujo, la configuración y la información de contexto especificados para el análisis.Creates a new XmlReader instance using the specified stream, settings, and context information for parsing.

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 Stream Stream Stream

Flujo que contiene los datos XML.The stream that contains the XML data.

XmlReader examina los primeros bytes de la secuencia buscando una marca de orden de bytes u otro signo de codificación.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. 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).When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Configuración de la nueva instancia XmlReader.The settings for the new XmlReader instance. Este valor puede ser null.This value can be null.

inputContext
XmlParserContext XmlParserContext XmlParserContext XmlParserContext

Información de contexto necesaria para analizar el fragmento XML.The context information required to parse the XML fragment. La información de contexto puede incluir la XmlNameTable que se va a usar, 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.The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

Este valor puede ser null.This value can be null.

Devoluciones

Objeto usado para leer los datos XML del flujo.An object that is used to read the XML data in the stream.

Excepciones

Comentarios

De forma predeterminada XmlUrlResolver , se utiliza una sin credenciales para tener acceso a recursos externos como una definición de tipo de documento (DTD), entidades, esquemas, etc.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partir de la .NET Framework 4.5.2, no XmlUrlResolver se proporciona ningún valor predeterminado.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Si la solución tiene como destino la .NET Framework 4.5.2 o versiones posteriores, XmlResolver especifique con XmlReaderSettings.XmlResolver la propiedad.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use XmlReaderSettings.XmlResolver la propiedad para especificar XmlResolver un con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

Puede usar uno de los métodos siguientes para controlar los recursos a los XmlReader que puede tener acceso:You can use one of the following methods to control which resources the XmlReader can access:

O bien-or-

  • No permita que XmlReader abra ningún recurso externo estableciendo la propiedad XmlResolver en null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

El objeto XmlReader creado expande las referencias de entidad y realiza la normalización XML de los caracteres de nueva línea.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String)

Crea una nueva instancia de XmlReader usando el flujo, el URI base y la configuración especificados.Creates a new XmlReader instance using the specified stream, base URI, and settings.

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);
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 Stream Stream Stream

Flujo que contiene los datos XML.The stream that contains the XML data.

XmlReader examina los primeros bytes de la secuencia buscando una marca de orden de bytes u otro signo de codificación.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. 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).When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Configuración de la nueva instancia XmlReader.The settings for the new XmlReader instance. Este valor puede ser null.This value can be null.

baseUri
String String String String

URI base de la entidad o documento que se lee.The base URI for the entity or document being read. Este valor puede ser null.This value can be null.

Nota sobre seguridad El URI base se usa para resolver el URI relativo del documento XML.Security Note The base URI is used to resolve the relative URI of the XML document. No use un URI base de un origen que no sea de confianza.Do not use a base URI from an untrusted source.

Devoluciones

Objeto usado para leer los datos XML del flujo.An object that is used to read the XML data in the stream.

Excepciones

Comentarios

De forma predeterminada XmlUrlResolver , se utiliza una sin credenciales para tener acceso a recursos externos como una definición de tipo de documento (DTD), entidades, esquemas, etc.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partir de la .NET Framework 4.5.2, no XmlUrlResolver se proporciona ningún valor predeterminado.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Si la solución tiene como destino la .NET Framework 4.5.2 o versiones posteriores, XmlResolver especifique con XmlReaderSettings.XmlResolver la propiedad.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use XmlReaderSettings.XmlResolver la propiedad para especificar XmlResolver un con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

Puede usar uno de los métodos siguientes para controlar los recursos a los XmlReader que puede tener acceso:You can use one of the following methods to control which resources the XmlReader can access:

O bien-or-

  • No permita que XmlReader abra ningún recurso externo estableciendo la propiedad XmlResolver en null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

El objeto XmlReader creado expande las referencias de entidad y realiza la normalización XML de los caracteres de nueva línea.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings)

Crea una nueva instancia de XmlReader con el lector XML y la configuración especificados.Creates a new XmlReader instance by using the specified XML reader and 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 XmlReader XmlReader XmlReader

Objeto que desea usar como lector XML subyacente.The object that you want to use as the underlying XML reader.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Configuración de la nueva instancia XmlReader.The settings for the new XmlReader instance.

El nivel de conformidad del objeto XmlReaderSettings debe coincidir con el del lector subyacente o establecerse en Auto.The conformance level of the XmlReaderSettings object must either match the conformance level of the underlying reader, or it must be set to Auto.

Devoluciones

Objeto que se encapsula alrededor del objeto XmlReader especificado.An object that is wrapped around the specified XmlReader object.

Excepciones

Si el objeto XmlReaderSettings especifica un nivel de conformidad que no es coherente con el nivel de conformidad del lector subyacente.If the XmlReaderSettings object specifies a conformance level that is not consistent with conformance level of the underlying reader.

O bien-or- El objeto XmlReader subyacente se encuentra en un estado Error o Closed.The underlying XmlReader is in an Error or Closed state.

Ejemplos

En el ejemplo siguiente se crea XmlReader un objeto de validación que se XmlNodeReader ajusta alrededor de un objeto.The following example creates a validating XmlReader object that is wrapped around an XmlNodeReader object.

// 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 .This method allows you add additional features to an underlying XmlReader object. El objeto XmlReader subyacente puede ser otro XmlReader objeto creado por el Create método o un XmlReader objeto creado mediante una de las implementaciones XmlReader concretas.The underlying XmlReader object can be another XmlReader object created by the Create method, or an XmlReader object created using one of the concrete XmlReader implementations.

Se usa XmlUrlResolver un valor predeterminado sin credenciales para tener acceso a los recursos externos, como un esquema.A default XmlUrlResolver with no credentials is used to access any external resources such as a schema.

Importante

A partir de la .NET Framework 4.5.2, no XmlUrlResolver se proporciona ningún valor predeterminado.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Si la solución tiene como destino la .NET Framework 4.5.2 o versiones posteriores, XmlResolver especifique con XmlReaderSettings.XmlResolver la propiedad.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, especifique XmlResolver un con las credenciales necesarias XmlReaderSettings.XmlResolver mediante la propiedad.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

Importante

Puede usar uno de los métodos siguientes para controlar los recursos a los XmlReader que puede tener acceso:You can use one of the following methods to control which resources the XmlReader can access:

O bien-or-

  • No permita que XmlReader abra ningún recurso externo estableciendo la propiedad XmlResolver en null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

El objeto XmlReader creado expande las referencias de entidad y realiza la normalización XML de los caracteres de nueva línea.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String)

Crea una nueva instancia de XmlReader mediante el lector de texto, la configuración y el URI base especificados.Creates a new XmlReader instance by using the specified text reader, settings, and base URI.

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);
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 TextReader TextReader TextReader

Lector de texto desde el que se leen los datos XML.The text reader from which to read the XML data. Un lector de texto devuelve un flujo de caracteres Unicode, por lo que el XmlReader no usa la codificación especificada en la declaración XML para descodificar el flujo de datos.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XmlReader to decode the data stream.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Configuración de la nueva instancia XmlReader.The settings for the new XmlReader instance. Este valor puede ser null.This value can be null.

baseUri
String String String String

URI base de la entidad o documento que se lee.The base URI for the entity or document being read. Este valor puede ser null.This value can be null.

Nota sobre seguridad El URI base se usa para resolver el URI relativo del documento XML.Security Note The base URI is used to resolve the relative URI of the XML document. No use un URI base de un origen que no sea de confianza.Do not use a base URI from an untrusted source.

Devoluciones

Objeto usado para leer los datos XML del flujo.An object that is used to read the XML data in the stream.

Excepciones

Comentarios

De forma predeterminada XmlUrlResolver , se utiliza una sin credenciales para tener acceso a recursos externos como una definición de tipo de documento (DTD), entidades, esquemas, etc.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partir de la .NET Framework 4.5.2, no XmlUrlResolver se proporciona ningún valor predeterminado.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Si la solución tiene como destino la .NET Framework 4.5.2 o versiones posteriores, XmlResolver especifique con XmlReaderSettings.XmlResolver la propiedad.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use XmlReaderSettings.XmlResolver la propiedad para especificar XmlResolver un con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

Puede usar uno de los métodos siguientes para controlar los recursos a los XmlReader que puede tener acceso:You can use one of the following methods to control which resources the XmlReader can access:

o bien-or-

  • No permita que XmlReader abra ningún recurso externo estableciendo la propiedad XmlResolver en null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

El objeto XmlReader creado expande las referencias de entidad y realiza la normalización XML de los caracteres de nueva línea.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings)

Crea una nueva instancia XmlReader usando el lector de texto y la configuración especificados.Creates a new XmlReader instance by using the specified text reader and 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 TextReader TextReader TextReader

Lector de texto desde el que se leen los datos XML.The text reader from which to read the XML data. Un lector de texto devuelve un flujo 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.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XML reader to decode the data stream.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Configuración del nuevo XmlReader.The settings for the new XmlReader. Este valor puede ser null.This value can be null.

Devoluciones

Objeto usado para leer los datos XML del flujo.An object that is used to read the XML data in the stream.

Excepciones

Comentarios

De forma predeterminada XmlUrlResolver , se utiliza una sin credenciales para tener acceso a recursos externos como una definición de tipo de documento (DTD), entidades, esquemas, etc.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partir de la .NET Framework 4.5.2, no XmlUrlResolver se proporciona ningún valor predeterminado.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Si la solución tiene como destino la .NET Framework 4.5.2 o versiones posteriores, XmlResolver especifique con XmlReaderSettings.XmlResolver la propiedad.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use XmlReaderSettings.XmlResolver la propiedad para especificar XmlResolver un con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

Puede usar uno de los métodos siguientes para controlar los recursos a los XmlReader que puede tener acceso:You can use one of the following methods to control which resources the XmlReader can access:

O bien-or-

  • No permita que XmlReader abra ningún recurso externo estableciendo la propiedad XmlResolver en null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

El objeto XmlReader creado expande las referencias de entidad y realiza la normalización XML de los caracteres de nueva línea.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings)

Crea una nueva instancia de XmlReader con el flujo y la configuración especificados.Creates a new XmlReader instance with the specified stream and 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 Stream Stream Stream

Flujo que contiene los datos XML.The stream that contains the XML data.

XmlReader examina los primeros bytes de la secuencia buscando una marca de orden de bytes u otro signo de codificación.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. 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).When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Configuración de la nueva instancia XmlReader.The settings for the new XmlReader instance. Este valor puede ser null.This value can be null.

Devoluciones

Objeto usado para leer los datos XML del flujo.An object that is used to read the XML data in the stream.

Excepciones

Comentarios

De forma predeterminada XmlUrlResolver , se utiliza una sin credenciales para tener acceso a recursos externos como una definición de tipo de documento (DTD), entidades, esquemas, etc.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partir de la .NET Framework 4.5.2, no XmlUrlResolver se proporciona ningún valor predeterminado.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Si la solución tiene como destino la .NET Framework 4.5.2 o versiones posteriores, XmlResolver especifique con XmlReaderSettings.XmlResolver la propiedad.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use XmlReaderSettings.XmlResolver la propiedad para especificar XmlResolver un con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

Puede usar uno de los métodos siguientes para controlar los recursos a los XmlReader que puede tener acceso:You can use one of the following methods to control which resources the XmlReader can access:

O bien-or-

  • No permita que XmlReader abra ningún recurso externo estableciendo la propiedad XmlResolver en null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

El objeto XmlReader creado expande las referencias de entidad y realiza la normalización XML de los caracteres de nueva línea.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String) Create(String) Create(String) Create(String)

Crea una nueva instancia de XmlReader con el URI especificado.Creates a new XmlReader instance with specified URI.

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 String String String

URI del archivo que contiene los datos XML.The URI for the file that contains the XML data. La clase XmlUrlResolver se utiliza para convertir la ruta de acceso en una representación de datos canónicos.The XmlUrlResolver class is used to convert the path to a canonical data representation.

Devoluciones

Objeto usado para leer los datos XML del flujo.An object that is used to read the XML data in the stream.

Excepciones

El valor inputUri es null.The inputUri value is null.

XmlReader no tiene permisos suficientes para obtener acceso a la ubicación de los datos XML.The XmlReader does not have sufficient permissions to access the location of the XML data.

No existe el archivo identificado por el URI.The file identified by the URI does not exist.

En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, capture en su lugar la excepción de clase base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

El formato del URI no es correcto.The URI format is not correct.

Ejemplos

En el ejemplo siguiente se XmlReader crea un objeto que lee el archivo de datos XML especificado por el URI.The following example creates an XmlReader object that reads XML data file specified by the 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 XmlReaderSettings utiliza un objeto con la configuración predeterminada para crear el lector.An XmlReaderSettings object with default settings is used to create the reader. Si desea especificar las características que se van a admitir en el lector creado, use la sobrecarga que toma XmlReaderSettings un objeto como uno de sus argumentos y pase un XmlReaderSettings objeto con la configuración correcta.If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

Se utiliza XmlUrlResolver un valor predeterminado sin credenciales para tener acceso a recursos externos como una definición de tipo de documento (DTD), entidades, esquemas, etc.A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partir de la .NET Framework 4.5.2, no XmlUrlResolver se proporciona ningún valor predeterminado.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Si la solución tiene como destino la .NET Framework 4.5.2 o versiones posteriores, XmlResolver especifique con XmlReaderSettings.XmlResolver la propiedad.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, especifique XmlResolver un con las credenciales necesarias XmlReaderSettings.XmlResolver mediante la propiedad.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

El objeto XmlReader creado expande las referencias de entidad y realiza la normalización XML de los caracteres de nueva línea.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader) Create(TextReader) Create(TextReader) Create(TextReader)

Crea una nueva instancia de XmlReader mediante el lector de texto especificado.Creates a new XmlReader instance by using the specified text reader.

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 TextReader TextReader TextReader

Lector de texto desde el que se leen los datos XML.The text reader from which to read the XML data. Un lector de texto devuelve un flujo 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.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration is not used by the XML reader to decode the data stream.

Devoluciones

Objeto usado para leer los datos XML del flujo.An object that is used to read the XML data in the stream.

Excepciones

Ejemplos

En el ejemplo siguiente se StringReader usa la clase para leer una cadena XML.The following example uses the StringReader class to read an XML string.

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 XmlReaderSettings utiliza un objeto con la configuración predeterminada para crear el lector.An XmlReaderSettings object with default settings is used to create the reader. Si desea especificar las características que se van a admitir en el lector creado, use la sobrecarga que toma XmlReaderSettings un objeto como uno de sus argumentos y pase un XmlReaderSettings objeto con la configuración correcta.If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

Se utiliza XmlUrlResolver un valor predeterminado sin credenciales para tener acceso a recursos externos como una definición de tipo de documento (DTD), entidades, esquemas, etc.A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partir de la .NET Framework 4.5.2, no XmlUrlResolver se proporciona ningún valor predeterminado.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Si la solución tiene como destino la .NET Framework 4.5.2 o versiones posteriores, XmlResolver especifique con XmlReaderSettings.XmlResolver la propiedad.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, especifique XmlResolver un con las credenciales necesarias XmlReaderSettings.XmlResolver mediante la propiedad.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

El objeto XmlReader creado expande las referencias de entidad y realiza la normalización XML de los caracteres de nueva línea.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream) Create(Stream) Create(Stream) Create(Stream)

Crea una nueva instancia XmlReader mediante el flujo especificado con la configuración predeterminada.Creates a new XmlReader instance using the specified stream with default settings.

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 Stream Stream Stream

Flujo que contiene los datos XML.The stream that contains the XML data.

XmlReader examina los primeros bytes de la secuencia buscando una marca de orden de bytes u otro signo de codificación.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. 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).When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

Devoluciones

Objeto usado para leer los datos XML del flujo.An object that is used to read the XML data in the stream.

Excepciones

XmlReader no tiene permisos suficientes para obtener acceso a la ubicación de los datos XML.The XmlReader does not have sufficient permissions to access the location of the XML data.

Ejemplos

En el ejemplo siguiente se XmlReader crea un objeto que lee FileStreamdesde un.The following example creates an XmlReader object that reads from a FileStream.


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 XmlReaderSettings utiliza un objeto con la configuración predeterminada para crear el lector.An XmlReaderSettings object with default settings is used to create the reader. Si desea especificar las características que se van a admitir en el lector creado, use la sobrecarga que toma XmlReaderSettings un objeto como uno de sus argumentos y pase un XmlReaderSettings objeto con la configuración correcta.If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

Se utiliza XmlUrlResolver un valor predeterminado sin credenciales para tener acceso a recursos externos como una definición de tipo de documento (DTD), entidades, esquemas, etc.A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partir de la .NET Framework 4.5.2, no XmlUrlResolver se proporciona ningún valor predeterminado.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Si la solución tiene como destino la .NET Framework 4.5.2 o versiones posteriores, XmlResolver especifique con XmlReaderSettings.XmlResolver la propiedad.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, especifique XmlResolver un con las credenciales necesarias XmlReaderSettings.XmlResolver mediante la propiedad.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

El objeto XmlReader creado expande las referencias de entidad y realiza la normalización XML de los caracteres de nueva línea.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String, XmlReaderSettings) Create(String, XmlReaderSettings) Create(String, XmlReaderSettings) Create(String, XmlReaderSettings)

Crea una nueva instancia de XmlReader usando el URI y la configuración especificados.Creates a new XmlReader instance by using the specified URI and settings.

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);
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 String String String

URI del archivo que contiene los datos XML.The URI for the file containing the XML data. El objeto XmlResolver del objeto XmlReaderSettings se utiliza para convertir la ruta de acceso en una representación de datos canónicos.The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. Si XmlResolver es null, se utiliza un nuevo objeto XmlUrlResolver.If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Configuración de la nueva instancia XmlReader.The settings for the new XmlReader instance. Este valor puede ser null.This value can be null.

Devoluciones

Objeto usado para leer los datos XML del flujo.An object that is used to read the XML data in the stream.

Excepciones

El valor inputUri es null.The inputUri value is null.

No se encuentra el archivo especificado por el URI.The file specified by the URI cannot be found.

En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, capture en su lugar la excepción de clase base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

El formato del URI no es correcto.The URI format is not correct.

Ejemplos

En el ejemplo siguiente se XmlReader crea un objeto que admite la validación de la definición de tipo de documento (DTD).The following example creates an XmlReader object that supports document type definition (DTD) validation.

// 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 XmlUrlResolver , se utiliza una sin credenciales para tener acceso a recursos externos como una definición de tipo de documento (DTD), entidades, esquemas, etc.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partir de la .NET Framework 4.5.2, no XmlUrlResolver se proporciona ningún valor predeterminado.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Si la solución tiene como destino la .NET Framework 4.5.2 o versiones posteriores, XmlResolver especifique con XmlReaderSettings.XmlResolver la propiedad.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Esto significa que XmlReader puede tener acceso a cualquier ubicación que no requiera autenticación.This means that the XmlReader can access any locations that does not require authentication. Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use XmlReaderSettings.XmlResolver la propiedad para especificar XmlResolver un con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

Puede restringir los recursos a los XmlReader que puede tener acceso estableciendo XmlResolver la propiedad en XmlSecureResolver un objeto.You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

El objeto XmlReader creado expande las referencias de entidad y realiza la normalización XML de los caracteres de nueva línea.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Se aplica a