XmlReader.Create Método

Definición

Espacio de nombres:

System.Xml

Ensamblados:

netstandard.dll, System.Xml.ReaderWriter.dll

Crea una nueva instancia de XmlReader.

Sobrecargas

Nombre	Description
Create(String, XmlReaderSettings, XmlParserContext)	Crea una nueva XmlReader instancia mediante el URI, la configuración y la información de contexto especificadas para el análisis.
Create(TextReader, XmlReaderSettings, XmlParserContext)	Crea una nueva XmlReader instancia mediante el lector de texto, la configuración y la información de contexto especificadas para el análisis.
Create(Stream, XmlReaderSettings, XmlParserContext)	Crea una nueva XmlReader instancia mediante la secuencia, la configuración y la información de contexto especificadas para el análisis.
Create(Stream, XmlReaderSettings, String)	Crea una nueva XmlReader instancia con la secuencia, el URI base y la configuración especificados.
Create(XmlReader, XmlReaderSettings)	Crea una nueva XmlReader instancia mediante el lector XML y la configuración especificados.
Create(TextReader, XmlReaderSettings, String)	Crea una nueva XmlReader instancia mediante el lector de texto, la configuración y el URI base especificados.
Create(TextReader, XmlReaderSettings)	Crea una nueva XmlReader instancia mediante el lector de texto y la configuración especificados.
Create(Stream, XmlReaderSettings)	Crea una nueva XmlReader instancia con la secuencia y la configuración especificadas.
Create(String)	Crea una nueva XmlReader instancia con el URI especificado.
Create(TextReader)	Crea una nueva XmlReader instancia mediante el lector de texto especificado.
Create(Stream)	Crea una nueva XmlReader instancia mediante el flujo especificado con la configuración predeterminada.
Create(String, XmlReaderSettings)	Crea una nueva XmlReader instancia mediante el URI y la configuración especificados.

Comentarios

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

Create(String, XmlReaderSettings, XmlParserContext)

Source:

XmlReader.cs

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

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);

public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

static member Create : string * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader

Public Shared Function Create (inputUri As String, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parámetros

inputUri

String

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

settings

XmlReaderSettings

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

inputContext

XmlParserContext

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

Este valor puede ser null.

Devoluciones

XmlReader

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

Excepciones

ArgumentNullException

El valor de inputUri es null.

SecurityException

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

ArgumentException

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

FileNotFoundException

No se encuentra el archivo especificado por el URI.

UriFormatException

El formato de URI no es correcto.

Comentarios

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

Importante

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

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

Importante

Puede restringir los recursos a los que XmlReader puede acceder 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.

Create(TextReader, XmlReaderSettings, XmlParserContext)

Source:

XmlReader.cs

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

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parámetros

input

TextReader

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

settings

XmlReaderSettings

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

inputContext

XmlParserContext

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

Este valor puede ser null.

Devoluciones

XmlReader

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

Excepciones

ArgumentNullException

El valor de input es null.

ArgumentException

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

Ejemplos

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

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

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

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

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

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

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

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

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

Comentarios

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

Importante

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

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

Importante

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

• Restrinja los recursos a los que XmlReader puede acceder configurando el valor de la propiedad XmlResolver en un objeto XmlSecureResolver.

O bien

• No permita que XmlReader abra ningún recurso externo al establecer 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.

Create(Stream, XmlReaderSettings, XmlParserContext)

Source:

XmlReader.cs

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

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader

Public Shared Function Create (input As Stream, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parámetros

input

Stream

Secuencia que contiene los datos XML.

XmlReader Examina los primeros bytes de la secuencia buscando una marca de orden de bytes u otro signo de codificación. Cuando se determina la codificación, la codificación se usa para continuar leyendo la secuencia y el procesamiento continúa a analizar la entrada como una secuencia de caracteres (Unicode).

settings

XmlReaderSettings

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

inputContext

XmlParserContext

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

Este valor puede ser null.

Devoluciones

XmlReader

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

Excepciones

ArgumentNullException

El valor de input es null.

Comentarios

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

Importante

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

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

Importante

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

• Restrinja los recursos a los que XmlReader puede acceder configurando el valor de la propiedad XmlResolver en un objeto XmlSecureResolver.

O bien

• No permita que XmlReader abra ningún recurso externo al establecer 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.

Create(Stream, XmlReaderSettings, String)

Source:

XmlReader.cs

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

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings, System::String ^ baseUri);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings? settings, string? baseUri);

static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader

Public Shared Function Create (input As Stream, settings As XmlReaderSettings, baseUri As String) As XmlReader

Parámetros

input

Stream

Secuencia que contiene los datos XML.

XmlReader Examina los primeros bytes de la secuencia buscando una marca de orden de bytes u otro signo de codificación. Cuando se determina la codificación, la codificación se usa para continuar leyendo la secuencia y el procesamiento continúa a analizar la entrada como una secuencia de caracteres (Unicode).

settings

XmlReaderSettings

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

baseUri

String

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

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

Devoluciones

XmlReader

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

Excepciones

ArgumentNullException

El valor de input es null.

Comentarios

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

Importante

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

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

Importante

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

• Restrinja los recursos a los que XmlReader puede acceder configurando el valor de la propiedad XmlResolver en un objeto XmlSecureResolver.

O bien

• No permita que XmlReader abra ningún recurso externo al establecer 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.

Create(XmlReader, XmlReaderSettings)

Source:

XmlReader.cs

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

public:
 static System::Xml::XmlReader ^ Create(System::Xml::XmlReader ^ reader, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(System.Xml.XmlReader reader, System.Xml.XmlReaderSettings? settings);

static member Create : System.Xml.XmlReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (reader As XmlReader, settings As XmlReaderSettings) As XmlReader

Parámetros

reader

XmlReader

Objeto que desea usar como lector XML subyacente.

settings

XmlReaderSettings

Configuración de la nueva XmlReader instancia.

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

Devoluciones

XmlReader

Objeto que se ajusta alrededor del objeto especificado XmlReader .

Excepciones

ArgumentNullException

El valor de reader es null.

InvalidOperationException

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

O bien

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

Ejemplos

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

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

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

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

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

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

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

Comentarios

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

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

Importante

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

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

Importante

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

• Restrinja los recursos a los que XmlReader puede acceder configurando el valor de la propiedad XmlResolver en un objeto XmlSecureResolver.

O bien

• No permita que XmlReader abra ningún recurso externo al establecer 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.

Create(TextReader, XmlReaderSettings, String)

Source:

XmlReader.cs

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

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings, System::String ^ baseUri);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, string? baseUri);

static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, baseUri As String) As XmlReader

Parámetros

input

TextReader

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

settings

XmlReaderSettings

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

baseUri

String

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

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

Devoluciones

XmlReader

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

Excepciones

ArgumentNullException

El valor de input es null.

Comentarios

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

Importante

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

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

Importante

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

• Restrinja los recursos a los que XmlReader puede acceder configurando el valor de la propiedad XmlResolver en un objeto XmlSecureResolver.

O bien

• No permita que XmlReader abra ningún recurso externo al establecer 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.

Create(TextReader, XmlReaderSettings)

Source:

XmlReader.cs

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

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings? settings);

static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader, settings As XmlReaderSettings) As XmlReader

Parámetros

input

TextReader

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

settings

XmlReaderSettings

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

Devoluciones

XmlReader

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

Excepciones

ArgumentNullException

El valor de input es null.

Comentarios

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

Importante

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

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

Importante

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

• Restrinja los recursos a los que XmlReader puede acceder configurando el valor de la propiedad XmlResolver en un objeto XmlSecureResolver.

O bien

• No permita que XmlReader abra ningún recurso externo al establecer 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.

Create(Stream, XmlReaderSettings)

Source:

XmlReader.cs

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

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings? settings);

static member Create : System.IO.Stream * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (input As Stream, settings As XmlReaderSettings) As XmlReader

Parámetros

input

Stream

Secuencia que contiene los datos XML.

XmlReader Examina los primeros bytes de la secuencia buscando una marca de orden de bytes u otro signo de codificación. Cuando se determina la codificación, la codificación se usa para continuar leyendo la secuencia y el procesamiento continúa a analizar la entrada como una secuencia de caracteres (Unicode).

settings

XmlReaderSettings

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

Devoluciones

XmlReader

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

Excepciones

ArgumentNullException

El valor de input es null.

Comentarios

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

Importante

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

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

Importante

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

• Restrinja los recursos a los que XmlReader puede acceder configurando el valor de la propiedad XmlResolver en un objeto XmlSecureResolver.

O bien

• No permita que XmlReader abra ningún recurso externo al establecer 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.

Create(String)

Source:

XmlReader.cs

Crea una nueva XmlReader instancia con el URI especificado.

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri);

public static System.Xml.XmlReader Create(string inputUri);

static member Create : string -> System.Xml.XmlReader

Public Shared Function Create (inputUri As String) As XmlReader

Parámetros

inputUri

String

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

Devoluciones

XmlReader

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

Excepciones

ArgumentNullException

El valor de inputUri es null.

SecurityException

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

FileNotFoundException

El archivo identificado por el URI no existe.

UriFormatException

El formato de URI no es correcto.

Nota: En .NET para aplicaciones de la Tienda Windows o la biblioteca de clases portable, capture la excepción de clase base, FormatException, en su lugar.

Ejemplos

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

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

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

Comentarios

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

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

Importante

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

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

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

Create(TextReader)

Source:

XmlReader.cs

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

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input);

public static System.Xml.XmlReader Create(System.IO.TextReader input);

static member Create : System.IO.TextReader -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader) As XmlReader

Parámetros

input

TextReader

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

Devoluciones

XmlReader

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

Excepciones

ArgumentNullException

El valor de input es null.

Ejemplos

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

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

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

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

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

Comentarios

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

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

Importante

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

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

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

Create(Stream)

Source:

XmlReader.cs

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

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input);

public static System.Xml.XmlReader Create(System.IO.Stream input);

static member Create : System.IO.Stream -> System.Xml.XmlReader

Public Shared Function Create (input As Stream) As XmlReader

Parámetros

input

Stream

Secuencia que contiene los datos XML.

XmlReader Examina los primeros bytes de la secuencia buscando una marca de orden de bytes u otro signo de codificación. Cuando se determina la codificación, la codificación se usa para continuar leyendo la secuencia y el procesamiento continúa a analizar la entrada como una secuencia de caracteres (Unicode).

Devoluciones

XmlReader

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

Excepciones

ArgumentNullException

El valor de input es null.

SecurityException

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

Ejemplos

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

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

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

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

End Sub

Comentarios

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

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

Importante

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

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

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

Create(String, XmlReaderSettings)

Source:

XmlReader.cs

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

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings? settings);

static member Create : string * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (inputUri As String, settings As XmlReaderSettings) As XmlReader

Parámetros

inputUri

String

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

settings

XmlReaderSettings

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

Devoluciones

XmlReader

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

Excepciones

ArgumentNullException

El valor de inputUri es null.

FileNotFoundException

No se encuentra el archivo especificado por el URI.

UriFormatException

El formato de URI no es correcto.

Nota: En .NET para aplicaciones de la Tienda Windows o la biblioteca de clases portable, capture la excepción de clase base, FormatException, en su lugar.

Ejemplos

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

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

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

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

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

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

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

Comentarios

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

Importante

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

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

Importante

Puede restringir los recursos a los que XmlReader puede acceder 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.