XmlReader.Create Método

Referencia

Definición

Espacio de nombres:: System.Xml

Ensamblado:: System.Xml.ReaderWriter.dll

Ensamblado:: System.Xml.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Crea una nueva instancia de XmlReader.

Sobrecargas

Create(String, XmlReaderSettings, XmlParserContext)	Crea una nueva instancia de XmlReader usando el URI, la configuración y la información de contexto especificados.
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.
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.
Create(Stream, XmlReaderSettings, String)	Crea una nueva instancia de XmlReader usando el flujo, el URI base y la configuración especificados.
Create(XmlReader, XmlReaderSettings)	Crea una nueva instancia de XmlReader con el lector XML y la configuración especificados.
Create(TextReader, XmlReaderSettings, String)	Crea una nueva instancia de XmlReader mediante el lector de texto, la configuración y el URI base especificados.
Create(TextReader, XmlReaderSettings)	Crea una nueva instancia XmlReader usando el lector de texto y la configuración especificados.
Create(Stream, XmlReaderSettings)	Crea una nueva instancia de XmlReader con el flujo y la configuración especificados.
Create(String)	Crea una nueva instancia de XmlReader con el URI especificado.
Create(TextReader)	Crea una nueva instancia de XmlReader mediante el lector de texto especificado.
Create(Stream)	Crea una nueva instancia XmlReader mediante el flujo especificado con la configuración predeterminada.
Create(String, XmlReaderSettings)	Crea una nueva instancia de XmlReader usando el URI y la configuración especificados.

Comentarios

Para obtener más información sobre esta API, consulte Comentarios complementarios de la API para XmlReader.Close.

Create(String, XmlReaderSettings, XmlParserContext)

Crea una nueva instancia de XmlReader usando el URI, la configuración y la información de contexto especificados.

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

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

settings: XmlReaderSettings

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

inputContext: XmlParserContext

Información de contexto necesaria para analizar el fragmento XML. La información de contexto puede incluirla 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.

Este valor puede ser null.

Devoluciones

XmlReader

Objeto usado para leer los datos XML del flujo.

Excepciones

ArgumentNullException

El valor inputUri es null.

SecurityException

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

ArgumentException

Tanto la propiedad NameTable como la propiedad NameTable contienen valores. (Solo se puede establecer y usar una de estas propiedades NameTable).

FileNotFoundException

No se encuentra el archivo especificado por el URI.

UriFormatException

El formato del URI no es correcto.

Comentarios

De forma predeterminada, se usa una XmlUrlResolver sin credenciales 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 mediante XmlResolver 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 con XmlResolver las credenciales necesarias.

Importante

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

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)

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.

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 leen los datos XML. 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.

settings: XmlReaderSettings

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

inputContext: XmlParserContext

Este valor puede ser null.

Devoluciones

XmlReader

Objeto usado para leer los datos XML del flujo.

Excepciones

ArgumentNullException

El valor input es null.

ArgumentException

Tanto la propiedad NameTable como la propiedad 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 una XmlUrlResolver sin credenciales para acceder a ningún recurso externo, como una definición de tipo de documento (DTD), entidades, esquemas, etc.

Importante

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

Importante

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

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

o bien

No permita que XmlReader abra ningún recurso externo estableciendo la propiedad XmlResolver en null.

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)

Crea una nueva instancia XmlReader con el flujo, la configuración y la información de contexto especificados 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

Flujo que contiene los datos XML.

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

settings: XmlReaderSettings

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

inputContext: XmlParserContext

Este valor puede ser null.

Devoluciones

XmlReader

Objeto usado para leer los datos XML del flujo.

Excepciones

ArgumentNullException

El valor input es null.

Comentarios

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

Importante

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

Importante

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

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

o bien

No permita que XmlReader abra ningún recurso externo estableciendo la propiedad XmlResolver en null.

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)

Crea una nueva instancia de XmlReader usando el flujo, 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

Flujo que contiene los datos XML.

settings: XmlReaderSettings

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

baseUri: String

URI base de la entidad o documento que se lee. Este valor puede ser null.

Nota sobre 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 usado para leer los datos XML del flujo.

Excepciones

ArgumentNullException

El valor input es null.

Comentarios

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

Importante

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 a qué recursos XmlReader puede acceder:

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

o bien

No permita que XmlReader abra ningún recurso externo estableciendo la propiedad XmlResolver en null.

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)

Crea una nueva instancia de XmlReader con 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 instancia XmlReader.

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

Devoluciones

XmlReader

Objeto que se encapsula alrededor del objeto XmlReader especificado.

Excepciones

ArgumentNullException

El valor reader es null.

InvalidOperationException

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

o bien

El objeto XmlReader subyacente se encuentra en un estado Error o Closed.

Ejemplos

En el ejemplo siguiente se crea un objeto de XmlReader validación 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 los recursos externos, como un esquema.

Importante

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

Importante

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

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

o bien

No permita que XmlReader abra ningún recurso externo estableciendo la propiedad XmlResolver en null.

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)

Crea una nueva instancia de XmlReader 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 leen los datos XML. 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.

settings: XmlReaderSettings

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

baseUri: String

URI base de la entidad o documento que se lee. Este valor puede ser null.

Nota sobre 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 usado para leer los datos XML del flujo.

Excepciones

ArgumentNullException

El valor input es null.

Comentarios

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

Importante

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 a qué recursos XmlReader puede acceder:

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

o bien

No permita que XmlReader abra ningún recurso externo estableciendo la propiedad XmlResolver en null.

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)

Crea una nueva instancia XmlReader usando 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

settings: XmlReaderSettings

Configuración del nuevo XmlReader. Este valor puede ser null.

Devoluciones

XmlReader

Objeto usado para leer los datos XML del flujo.

Excepciones

ArgumentNullException

El valor input es null.

Comentarios

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

Importante

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 a qué recursos XmlReader puede acceder:

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

o bien

No permita que XmlReader abra ningún recurso externo estableciendo la propiedad XmlResolver en null.

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)

Crea una nueva instancia de XmlReader con el flujo y la configuración especificados.

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

Flujo que contiene los datos XML.

settings: XmlReaderSettings

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

Devoluciones

XmlReader

Objeto usado para leer los datos XML del flujo.

Excepciones

ArgumentNullException

El valor input es null.

Comentarios

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

Importante

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 a qué recursos XmlReader puede acceder:

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

o bien

No permita que XmlReader abra ningún recurso externo estableciendo la propiedad XmlResolver en null.

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)

Crea una nueva instancia de XmlReader 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

URI del archivo que contiene los datos XML. La clase XmlUrlResolver se utiliza para convertir la ruta de acceso en una representación de datos canónicos.

Devoluciones

XmlReader

Objeto usado para leer los datos XML del flujo.

Excepciones

ArgumentNullException

El valor inputUri es null.

SecurityException

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

FileNotFoundException

No existe el archivo identificado por el URI.

UriFormatException

El formato del URI no es correcto.

Nota: En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, detecte 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 que se admitirán en 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

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, especifique con XmlResolver 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)

Crea una nueva instancia de XmlReader 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

Devoluciones

XmlReader

Objeto usado para leer los datos XML del flujo.

Excepciones

ArgumentNullException

El valor 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

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

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, especifique con XmlResolver 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)

Crea una nueva instancia XmlReader 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

Flujo que contiene los datos XML.

Devoluciones

XmlReader

Objeto usado para leer los datos XML del flujo.

Excepciones

ArgumentNullException

El valor 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

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

Si el recurso externo se encuentra en un recurso de red que requiere autenticación, especifique con XmlResolver 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)

Crea una nueva instancia de XmlReader usando 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

settings: XmlReaderSettings

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

Devoluciones

XmlReader

Objeto usado para leer los datos XML del flujo.

Excepciones

ArgumentNullException

El valor inputUri es null.

FileNotFoundException

No se encuentra el archivo especificado por el URI.

UriFormatException

El formato del URI no es correcto.

Nota: En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, detecte 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 una XmlUrlResolver sin credenciales para acceder a ningún recurso externo, como una definición de tipo de documento (DTD), entidades, esquemas, etc.

Importante

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

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

Se aplica a