XmlDocument.Load XmlDocument.Load XmlDocument.Load XmlDocument.Load Method

Definición

Carga los datos XML especificados de Stream, una dirección URL, un TextReader o un XmlReader.Loads the specified XML data from a Stream, a URL, a TextReader, or an XmlReader.

Sobrecargas

Load(Stream) Load(Stream) Load(Stream) Load(Stream)

Carga el documento XML desde el flujo especificado.Loads the XML document from the specified stream.

Load(TextReader) Load(TextReader) Load(TextReader) Load(TextReader)

Carga el documento XML desde el TextReader especificado.Loads the XML document from the specified TextReader.

Load(String) Load(String) Load(String) Load(String)

Carga el documento XML desde la dirección URL especificada.Loads the XML document from the specified URL.

Load(XmlReader) Load(XmlReader) Load(XmlReader) Load(XmlReader)

Carga el documento XML desde el XmlReader especificado.Loads the XML document from the specified XmlReader.

Load(Stream) Load(Stream) Load(Stream) Load(Stream)

Carga el documento XML desde el flujo especificado.Loads the XML document from the specified stream.

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

Secuencia que contiene el documento XML que se va a cargar.The stream containing the XML document to load.

Excepciones

Hay un error de carga o de análisis en el archivo XML.There is a load or parse error in the XML. En este caso, se genera una FileNotFoundException.In this case, a FileNotFoundException is raised.

Comentarios

Nota

El Load método siempre conserva el espacio en blanco significativo.The Load method always preserves significant white space. La PreserveWhitespace propiedad determina si se conserva o no un espacio en blanco insignificante, que es un espacio en blanco en el contenido del elemento.The PreserveWhitespace property determines whether or not insignificant white space, that is white space in element content, is preserved. El valor predeterminado falsees; no se conserva el espacio en blanco del contenido del elemento.The default is false; white space in element content is not preserved.

Si desea que se produzca la validación, puede crear una instancia XmlReader de validación mediante la XmlReaderSettings clase y el Create método.If you want validation to occur, you can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader.For more information, see the Remarks section of the XmlReader reference page.

Este método es una extensión de Microsoft para el Document Object Model (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Este método detecta automáticamente el formato de cadena del XML de entrada (por ejemplo, UTF-8, ANSI, etc.).This method automatically detects the string format of the input XML (for example, UTF-8, ANSI, and so on). Si la aplicación necesita saber qué codificación se usa para leer la secuencia, considere la posibilidad de usar XmlTextReader un objeto para leer la secuencia y, a continuación XmlTextReader.Encoding , use la propiedad para determinar la codificación.If your application needs to know which encoding is used to read the stream, consider using an XmlTextReader object to read the stream, and then use the XmlTextReader.Encoding property to determine the encoding. Si necesita usar un XmlDocument objeto para trabajar con XML, puede utilizar el XmlTextReader objeto para crear uno.If you need to use a XmlDocument object to work with XML, you can use the XmlTextReader object to create one. Para obtener más información, vea leer datos XML con XPathDocument y XmlDocument.For more information, see Reading XML Data using XPathDocument and XmlDocument.

Consulte también:

Load(TextReader) Load(TextReader) Load(TextReader) Load(TextReader)

Carga el documento XML desde el TextReader especificado.Loads the XML document from the specified 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 TextReader TextReader

TextReader que se usa para introducir los datos XML en el documento.The TextReader used to feed the XML data into the document.

Excepciones

Hay un error de carga o de análisis en el archivo XML.There is a load or parse error in the XML. En este caso, el documento permanece vacío.In this case, the document remains empty.

Ejemplos

En el ejemplo siguiente se StringReader usa la clase para cargar una cadena de datos XML XmlDocument en el objeto.The following example uses the StringReader class to load a string of XML data into the XmlDocument object.

#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 el espacio en blanco significativo.The Load method always preserves significant white space. La PreserveWhitespace propiedad determina si se conserva o no un espacio en blanco insignificante, que es un espacio en blanco en el contenido del elemento.The PreserveWhitespace property determines whether or not insignificant white space, that is white space in element content, is preserved. El valor predeterminado falsees; no se conserva el espacio en blanco del contenido del elemento.The default is false; white space in element content is not preserved.

Si desea que se produzca la validación, puede crear una instancia XmlReader de validación mediante la XmlReaderSettings clase y el Create método.If you want validation to occur, you can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader.For more information, see the Remarks section of the XmlReader reference page.

Este método es una extensión de Microsoft para el Document Object Model (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Consulte también:

Load(String) Load(String) Load(String) Load(String)

Carga el documento XML desde la dirección URL especificada.Loads the XML document from the specified URL.

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

Dirección URL del archivo que contiene el documento XML que se va a cargar.URL for the file containing the XML document to load. La dirección URL puede ser un archivo local o una dirección HTTP URL (una dirección web).The URL can be either a local file or an HTTP URL (a Web address).

Excepciones

Hay un error de carga o de análisis en el archivo XML.There is a load or parse error in the XML. En este caso, se genera una FileNotFoundException.In this case, a FileNotFoundException is raised.

filename es una cadena de longitud cero que solo contiene espacios en blanco o uno o varios caracteres no válidos definidos por InvalidPathChars.filename is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.The specified path, file name, or both exceed the system-defined maximum length.

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).The specified path is invalid (for example, it is on an unmapped drive).

Se produjo un error de E/S al abrir el archivo.An I/O error occurred while opening the file.

filename especificó un archivo que es de solo lectura.filename specified a file that is read-only.

o bien-or- Esta operación no es compatible con la plataforma actual.This operation is not supported on the current platform.

o bien-or- filename especificó un directorio.filename specified a directory.

O bien-or- El llamador no dispone del permiso requerido.The caller does not have the required permission.

No se encontró el archivo especificado en filename.The file specified in filename was not found.

filename está en un formato no válido.filename is in an invalid format.

El llamador no dispone del permiso requerido.The caller does not have the required permission.

Comentarios

Nota

El Load método siempre conserva el espacio en blanco significativo.The Load method always preserves significant white space. La PreserveWhitespace propiedad determina si se conserva o no un espacio en blanco insignificante, que es un espacio en blanco en el contenido del elemento.The PreserveWhitespace property determines whether or not insignificant white space, that is white space in element content, is preserved. El valor predeterminado falsees; no se conserva el espacio en blanco del contenido del elemento.The default is false; white space in element content is not preserved.

Si desea que se produzca la validación, puede crear una instancia XmlReader de validación mediante la XmlReaderSettings clase y el Create método.If you want validation to occur, you can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader.For more information, see the Remarks section of the XmlReader reference page.

Este método es una extensión de Microsoft para el Document Object Model (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Consulte también:

Load(XmlReader) Load(XmlReader) Load(XmlReader) Load(XmlReader)

Carga el documento XML desde el XmlReader especificado.Loads the XML document from the specified 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 XmlReader XmlReader

XmlReader que se usa para introducir los datos XML en el documento.The XmlReader used to feed the XML data into the document.

Excepciones

Hay un error de carga o de análisis en el archivo XML.There is a load or parse error in the XML. En este caso, el documento permanece vacío.In this case, the document remains empty.

Ejemplos

En el ejemplo siguiente se carga el último nodo de books.xml libro del archivo en el documento XML.The following example loads the last book node of the books.xml file into the XML document.

#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 books.xmlarchivo,, como entrada.The example uses the file, books.xml, as input.

<?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 el espacio en blanco significativo.The Load method always preserves significant white space. La PreserveWhitespace propiedad determina si se conserva o no un espacio en blanco insignificante, que es un espacio en blanco en el contenido del elemento.The PreserveWhitespace property determines whether or not insignificant white space, that is white space in element content, is preserved. El valor predeterminado falsees; no se conserva el espacio en blanco del contenido del elemento.The default is false; white space in element content is not preserved.

Si el lector está en el estado inicial (ReadState = ReadState. Initial), Load consume todo el contenido del lector y crea el Dom a partir de lo que encuentra.If the reader is in the initial state (ReadState =ReadState.Initial), Load consumes the entire contents of the reader and builds the DOM from what it finds.

Si el lector ya está situado en algún nodo con 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".If the reader is already positioned on some node at depth "n", this method loads that node and all subsequent siblings up to the end tag that closes depth "n". Esto tiene los siguientes resultados.This has the following results.

Si el nodo actual y sus elementos relacionados tienen el aspecto siguiente:If the current node and its siblings look like the following:

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

Loadproduce una excepción porque un documento no puede tener dos elementos de nivel raíz.Load throws an exception because a document cannot have two root level elements. Si el nodo actual y sus elementos relacionados tienen el aspecto siguiente:If the current node and its siblings look like the following:

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

Loadse realiza correctamente, pero tiene un árbol DOM incompleto porque no hay ningún elemento de nivel de raíz.Load succeeds, but you have an incomplete DOM tree because there is no root level element. Antes de guardar el documento, debe agregar un elemento de nivel de raíz; Save de lo contrario, producirá una excepción.Before you save the document, you must add a root level element, otherwise Save will throw an exception.

Si el lector está situado 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.If the reader is positioned on a leaf node that is invalid for the root level of a document, for example a white space or attribute node, the reader continues to read until it is positioned on a node that can be used for the root. El documento comienza a cargarse en este punto.The document begins loading at this point.

Si desea que se produzca la validación, puede crear una instancia XmlReader de validación mediante la XmlReaderSettings clase y el Create método.If you want validation to occur, you can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader.For more information, see the Remarks section of the XmlReader reference page.

Este método es una extensión de Microsoft para el Document Object Model (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Consulte también:

Se aplica a