Compartir vía

XmlReader.Create Método

  • Referencia

Definición

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

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)

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

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 un XmlUrlResolver sin credenciales para tener acceso a recursos externos, como una definición de tipo de documento (DTD), entidades, esquemas, etc.

Importante

A partir de .NET Framework 4.5.2, no se proporciona ningún valor predeterminado XmlUrlResolver . Si la solución tiene como destino .NET Framework 4.5.2 o versiones posteriores, especifique 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 un XmlResolver con 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)

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

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

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 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 un XmlUrlResolver sin credenciales para tener acceso a recursos externos, como una definición de tipo de documento (DTD), entidades, esquemas, etc.

Importante

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

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

Importante

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

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)

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

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

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

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 .

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:

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)

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

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.

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.

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

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 .

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:

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)

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

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

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 .

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:

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)

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

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

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 .

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:

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)

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

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

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

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 .

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:

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)

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

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.

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.

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

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 .

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:

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)

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

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

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 .

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)

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

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

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.

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

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

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 .

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)

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

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.

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

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

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

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 .

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)

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

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

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.

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

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