XmlDocument.Load Método

Definición

Espacio de nombres:

System.Xml

Ensamblados:

netstandard.dll, System.Xml.ReaderWriter.dll

Carga los datos XML especificados de , Streamuna dirección URL, o TextReader.XmlReader

Sobrecargas

Nombre	Description
Load(Stream)	Carga el documento XML desde la secuencia especificada.
Load(TextReader)	Carga el documento XML del especificado TextReader.
Load(String)	Carga el documento XML desde la dirección URL especificada.
Load(XmlReader)	Carga el documento XML del especificado XmlReader.

Load(Stream)

Source:

XmlDocument.cs

Carga el documento XML desde la secuencia especificada.

public:
 virtual void Load(System::IO::Stream ^ inStream);

public virtual void Load(System.IO.Stream inStream);

abstract member Load : System.IO.Stream -> unit
override this.Load : System.IO.Stream -> unit

Public Overridable Sub Load (inStream As Stream)

Parámetros

inStream

Stream

Secuencia que contiene el documento XML que se va a cargar.

Excepciones

XmlException

Hay un error de carga o análisis en el XML. En este caso, se genera un FileNotFoundException .

Comentarios

Nota:

El Load método siempre conserva un espacio en blanco significativo. La PreserveWhitespace propiedad determina si se conserva o no un espacio en blanco insignificante, que es espacio en blanco en el contenido del elemento. El valor predeterminado es false; el espacio en blanco del contenido del elemento no se conserva.

Si desea que se produzca la validación, puede crear una instancia de validación XmlReader mediante la XmlReaderSettings clase y el Create método . Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader.

Este método es una extensión de Microsoft para document Object Model (DOM).

Este método detecta automáticamente el formato de cadena del XML de entrada (por ejemplo, UTF-8, ANSI, etc.). Si la aplicación necesita saber qué codificación se usa para leer la secuencia, considere la posibilidad de usar un XmlTextReader objeto para leer la secuencia y, a continuación, use la XmlTextReader.Encoding propiedad para determinar la codificación. Si necesita usar un XmlDocument objeto para trabajar con XML, puede usar el XmlTextReader objeto para crear uno. Para obtener más información, vea Lectura de datos XML mediante XPathDocument y XmlDocument.

Consulte también

• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(TextReader)

Source:

XmlDocument.cs

Carga el documento XML del especificado TextReader.

public:
 virtual void Load(System::IO::TextReader ^ txtReader);

public virtual void Load(System.IO.TextReader txtReader);

abstract member Load : System.IO.TextReader -> unit
override this.Load : System.IO.TextReader -> unit

Public Overridable Sub Load (txtReader As TextReader)

Parámetros

txtReader

TextReader

TextReader que se usa para alimentar los datos XML en el documento.

Excepciones

XmlException

Hay un error de carga o análisis en el XML. En este caso, el documento permanece vacío.

Ejemplos

En el ejemplo siguiente se usa la StringReader clase para cargar una cadena de datos XML en el XmlDocument objeto .

using System;
using System.IO;
using System.Xml;

public class Sample1
{
  public static void CreateElementExample()
  {
    // Create the XmlDocument.
    XmlDocument doc = new();
    string xmlData = "<book xmlns:bk='urn:samples'></book>";

    doc.Load(new StringReader(xmlData));

    // Create a new element and add it to the document.
    XmlElement elem = doc.CreateElement("bk", "genre", "urn:samples");
    elem.InnerText = "fantasy";
    doc.DocumentElement.AppendChild(elem);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);
  }
}

Imports System.IO
Imports System.Xml

public class Sample 

  public shared sub Main() 

    ' Create the XmlDocument.
    Dim doc as XmlDocument = new XmlDocument()
    Dim xmlData as string = "<book xmlns:bk='urn:samples'></book>"

    doc.Load(new StringReader(xmlData))

    ' Create a new element and add it to the document.
    Dim elem as XmlElement = doc.CreateElement("bk", "genre", "urn:samples")
    elem.InnerText = "fantasy"
    doc.DocumentElement.AppendChild(elem)

    Console.WriteLine("Display the modified XML...")
    doc.Save(Console.Out)

  end sub
end class

Comentarios

Nota:

El Load método siempre conserva un espacio en blanco significativo. La PreserveWhitespace propiedad determina si se conserva o no un espacio en blanco insignificante, que es espacio en blanco en el contenido del elemento. El valor predeterminado es false; el espacio en blanco del contenido del elemento no se conserva.

Si desea que se produzca la validación, puede crear una instancia de validación XmlReader mediante la XmlReaderSettings clase y el Create método . Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader.

Este método es una extensión de Microsoft para document Object Model (DOM).

Consulte también

• StreamReader
• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(String)

Source:

XmlDocument.cs

Carga el documento XML desde la dirección URL especificada.

public:
 virtual void Load(System::String ^ filename);

public virtual void Load(string filename);

abstract member Load : string -> unit
override this.Load : string -> unit

Public Overridable Sub Load (filename As String)

Parámetros

filename

String

Dirección URL del archivo que contiene el documento XML que se va a cargar. La dirección URL puede ser un archivo local o una dirección URL HTTP (una dirección web).

Excepciones

XmlException

Hay un error de carga o análisis en el XML. En este caso, se genera un FileNotFoundException .

ArgumentException

filename es una cadena de longitud cero, contiene solo espacios en blanco o contiene uno o varios caracteres no válidos, tal como se define en InvalidPathChars.

ArgumentNullException

filename es null.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

DirectoryNotFoundException

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).

IOException

Error de E/S al abrir el archivo.

UnauthorizedAccessException

filename especificó un archivo que es de solo lectura.

O bien

Esta operación no se admite en la plataforma actual.

O bien

filename especificó un directorio.

O bien

El autor de la llamada no tiene el permiso necesario.

FileNotFoundException

No se encontró el archivo especificado en filename .

NotSupportedException

filename tiene un formato no válido.

SecurityException

El autor de la llamada no tiene el permiso necesario.

Comentarios

Nota:

El Load método siempre conserva un espacio en blanco significativo. La PreserveWhitespace propiedad determina si se conserva o no un espacio en blanco insignificante, que es espacio en blanco en el contenido del elemento. El valor predeterminado es false; el espacio en blanco del contenido del elemento no se conserva.

Si desea que se produzca la validación, puede crear una instancia de validación XmlReader mediante la XmlReaderSettings clase y el Create método . Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader.

Este método es una extensión de Microsoft para document Object Model (DOM).

Consulte también

• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(XmlReader)

Source:

XmlDocument.cs

Carga el documento XML del especificado XmlReader.

public:
 virtual void Load(System::Xml::XmlReader ^ reader);

public virtual void Load(System.Xml.XmlReader reader);

abstract member Load : System.Xml.XmlReader -> unit
override this.Load : System.Xml.XmlReader -> unit

Public Overridable Sub Load (reader As XmlReader)

Parámetros

reader

XmlReader

XmlReader que se usa para alimentar los datos XML en el documento.

Excepciones

XmlException

Hay un error de carga o análisis en el XML. En este caso, el documento permanece vacío.

Ejemplos

En el ejemplo siguiente se carga el último nodo de libro del books.xml archivo en el documento XML.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    //Create the XmlDocument.
    XmlDocument doc = new XmlDocument();

    //Load the document with the last book node.
    XmlTextReader reader = new XmlTextReader("books.xml");
    reader.WhitespaceHandling = WhitespaceHandling.None;
    reader.MoveToContent();
    reader.Read();
    reader.Skip(); //Skip the first book.
    reader.Skip(); //Skip the second book.
    doc.Load(reader);

    doc.Save(Console.Out);
  }
}

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        'Create the XmlDocument.
        Dim doc As New XmlDocument()
        
        'Load the document with the last book node.
        Dim reader As New XmlTextReader("books.xml")
        reader.WhitespaceHandling = WhitespaceHandling.None
        reader.MoveToContent()
        reader.Read()
        reader.Skip() 'Skip the first book.
        reader.Skip() 'Skip the second book.
        doc.Load(reader)
        
        doc.Save(Console.Out)
    End Sub
End Class

En el ejemplo se usa el archivo , books.xmlcomo entrada.

<?xml version='1.0'?>
<!-- This file represents a fragment of a book store inventory database -->
<bookstore>
  <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0">
    <title>The Autobiography of Benjamin Franklin</title>
    <author>
      <first-name>Benjamin</first-name>
      <last-name>Franklin</last-name>
    </author>
    <price>8.99</price>
  </book>
  <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2">
    <title>The Confidence Man</title>
    <author>
      <first-name>Herman</first-name>
      <last-name>Melville</last-name>
    </author>
    <price>11.99</price>
  </book>
  <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6">
    <title>The Gorgias</title>
    <author>
      <name>Plato</name>
    </author>
    <price>9.99</price>
  </book>
</bookstore>

Comentarios

Nota:

El Load método siempre conserva un espacio en blanco significativo. La PreserveWhitespace propiedad determina si se conserva o no un espacio en blanco insignificante, que es espacio en blanco en el contenido del elemento. El valor predeterminado es false; el espacio en blanco del contenido del elemento no se conserva.

Si el lector está en estado inicial (ReadState =ReadState.Initial), Load consume todo el contenido del lector y compila el DOM a partir de lo que encuentra.

Si el lector ya está colocado en algún nodo en la profundidad "n", este método carga ese nodo y todos los elementos del mismo nivel posteriores hasta la etiqueta final que cierra la profundidad "n". Esto tiene los siguientes resultados.

Si el nodo actual y sus elementos relacionados tienen un aspecto similar al siguiente:

<!--comment--><element1>one</element1><element2>two</element2>

Load produce una excepción porque un documento no puede tener dos elementos de nivel raíz. Si el nodo actual y sus elementos relacionados tienen un aspecto similar al siguiente:

<!--comment--><?process instruction?><!--comment--></endtag>

Load se realiza correctamente, pero tiene un árbol DOM incompleto porque no hay ningún elemento de nivel raíz. Antes de guardar el documento, debe agregar un elemento de nivel raíz; de lo contrario Save , producirá una excepción.

Si el lector se coloca en un nodo hoja que no es válido para el nivel raíz de un documento, por ejemplo, un espacio en blanco o un nodo de atributo, el lector continúa leyendo hasta que se coloca en un nodo que se puede usar para la raíz. El documento comienza a cargarse en este momento.

Si desea que se produzca la validación, puede crear una instancia de validación XmlReader mediante la XmlReaderSettings clase y el Create método . Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader.

Este método es una extensión de Microsoft para document Object Model (DOM).

Consulte también

• ValidationEventArgs
• XmlSeverityType
• Schemas