XmlDocument.Load Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Carga los datos XML especificados de Stream, una dirección URL, un TextReader o un XmlReader.

Sobrecargas

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

Load(Stream)

Source:

XmlDocument.cs

Carga el documento XML desde el flujo especificado.

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 de análisis en el archivo XML. En este caso, se genera una FileNotFoundException.

Comentarios

Nota

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

Si desea que se produzca la validación, puede crear una instancia de XmlReader validación 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 al Modelo de objetos de documento (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 con XPathDocument y XmlDocument.

Consulte también

• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(TextReader)

Source:

XmlDocument.cs

Carga el documento XML desde el TextReader especificado.

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 introducir los datos XML en el documento.

Excepciones

XmlException

Hay un error de carga o de análisis en el archivo 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.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   // Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   String^ xmlData = "<book xmlns:bk='urn:samples'></book>";
   doc->Load( gcnew 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 );
}

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

public class Sample {

  public static void Main() {

    // Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    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 conservan o no espacios en blanco insignificantes, que son espacios en blanco en el contenido del elemento. El valor predeterminado es false; no se conserva el espacio en blanco en el contenido del elemento.

Si desea que se produzca la validación, puede crear una instancia de XmlReader validación 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 al Modelo de objetos de documento (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 HTTP URL (una dirección web).

Excepciones

XmlException

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

ArgumentException

filename es una cadena de longitud cero que solo contiene espacios en blanco o uno o varios caracteres no válidos definidos por 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

Se produjo un error de E/S al abrir el archivo.

UnauthorizedAccessException

filename especificó un archivo que es de solo lectura.

o bien

Esta operación no es compatible con la plataforma actual.

o bien

filename especificó un directorio.

o bien

El llamador no dispone del permiso requerido.

FileNotFoundException

No se encontró el archivo especificado en filename.

NotSupportedException

filename está en un formato no válido.

SecurityException

El llamador no dispone del permiso requerido.

Comentarios

Nota

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

Si desea que se produzca la validación, puede crear una instancia de XmlReader validación 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 al Modelo de objetos de documento (DOM).

Consulte también

• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(XmlReader)

Source:

XmlDocument.cs

Carga el documento XML desde el XmlReader especificado.

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 introducir los datos XML en el documento.

Excepciones

XmlException

Hay un error de carga o de análisis en el archivo 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.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   //Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   
   //Load the document with the last book node.
   XmlTextReader^ reader = gcnew 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 );
}

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 conservan o no espacios en blanco insignificantes, que son espacios en blanco en el contenido del elemento. El valor predeterminado es false; no se conserva el espacio en blanco en el contenido del elemento.

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 del mismo nivel tienen el siguiente aspecto:

<!--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 del mismo nivel tienen el siguiente aspecto:

<!--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 punto.

Si desea que se produzca la validación, puede crear una instancia de XmlReader validación 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 al Modelo de objetos de documento (DOM).

Consulte también

• ValidationEventArgs
• XmlSeverityType
• Schemas