XmlDocument.Load Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Carrega os dados XML especificados de um Stream, uma URL, um TextReader ou um XmlReader.

Sobrecargas

Load(Stream)	Carrega o documento XML do fluxo especificado.
Load(TextReader)	Carrega o documento XML da TextReader especificada.
Load(String)	Carrega o documento XML da URL especificada.
Load(XmlReader)	Carrega o documento XML da XmlReader especificada.

Load(Stream)

Origem:

XmlDocument.cs

Carrega o documento XML do fluxo 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

O fluxo que contém o documento XML a ser carregado.

Exceções

XmlException

Há um erro de carregamento ou de análise no XML. Nesse caso, um FileNotFoundException é acionado.

Comentários

Observação

O Load método sempre preserva um espaço em branco significativo. A PreserveWhitespace propriedade determina se o espaço em branco insignificante ou não, que é espaço em branco no conteúdo do elemento, é preservado. O padrão é false; o espaço em branco no conteúdo do elemento não é preservado.

Se quiser que a validação ocorra, você poderá criar uma instância de validação XmlReader usando a XmlReaderSettings classe e o Create método . Para obter mais informações, consulte a seção de Comentários da página de referência XmlReader.

Esse método é uma extensão da Microsoft para o DOM (Modelo de Objeto de Documento).

Esse método detecta automaticamente o formato de cadeia de caracteres do XML de entrada (por exemplo, UTF-8, ANSI e assim por diante). Se o aplicativo precisar saber qual codificação é usada para ler o fluxo, considere usar um XmlTextReader objeto para ler o fluxo e, em seguida, use a XmlTextReader.Encoding propriedade para determinar a codificação. Se você precisar usar um XmlDocument objeto para trabalhar com XML, poderá usar o XmlTextReader objeto para criar um. Para obter mais informações, consulte Lendo dados XML usando XPathDocument e XmlDocument.

Confira também

• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(TextReader)

Origem:

XmlDocument.cs

Carrega o documento XML da TextReader especificada.

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

O TextReader usado para alimentar os dados XML no documento.

Exceções

XmlException

Há um erro de carregamento ou de análise no XML. Nesse caso, o documento permanece vazio.

Exemplos

O exemplo a seguir usa a StringReader classe para carregar uma cadeia de caracteres de dados XML no 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

Comentários

Observação

O Load método sempre preserva um espaço em branco significativo. A PreserveWhitespace propriedade determina se o espaço em branco insignificante ou não, que é espaço em branco no conteúdo do elemento, é preservado. O padrão é false; o espaço em branco no conteúdo do elemento não é preservado.

Se quiser que a validação ocorra, você poderá criar uma instância de validação XmlReader usando a XmlReaderSettings classe e o Create método . Para obter mais informações, consulte a seção de Comentários da página de referência XmlReader.

Esse método é uma extensão da Microsoft para o DOM (Modelo de Objeto de Documento).

Confira também

• StreamReader
• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(String)

Origem:

XmlDocument.cs

Carrega o documento XML da 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

URL do arquivo que contém o documento XML a ser carregado. A URL pode ser um arquivo local ou uma URL HTTP (um endereço Web).

Exceções

XmlException

Há um erro de carregamento ou de análise no XML. Nesse caso, um FileNotFoundException é acionado.

ArgumentException

filename é uma cadeia de comprimento zero, contém somente espaços em branco ou um ou mais caracteres inválidos, conforme definido por InvalidPathChars.

ArgumentNullException

filename é null.

PathTooLongException

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

DirectoryNotFoundException

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).

IOException

Um erro de E/S ocorreu ao abrir o arquivo.

UnauthorizedAccessException

filename especificou um arquivo somente leitura.

- ou -

Não há suporte para essa operação na plataforma atual.

- ou -

filename especificou um diretório.

- ou -

O chamador não tem a permissão necessária.

FileNotFoundException

O arquivo especificado em filename não foi encontrado.

NotSupportedException

filename está em um formato inválido.

SecurityException

O chamador não tem a permissão necessária.

Comentários

Observação

O Load método sempre preserva um espaço em branco significativo. A PreserveWhitespace propriedade determina se o espaço em branco insignificante ou não, que é espaço em branco no conteúdo do elemento, é preservado. O padrão é false; o espaço em branco no conteúdo do elemento não é preservado.

Se quiser que a validação ocorra, você poderá criar uma instância de validação XmlReader usando a XmlReaderSettings classe e o Create método . Para obter mais informações, consulte a seção de Comentários da página de referência XmlReader.

Esse método é uma extensão da Microsoft para o DOM (Modelo de Objeto de Documento).

Confira também

• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(XmlReader)

Origem:

XmlDocument.cs

Carrega o documento XML da XmlReader especificada.

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

O XmlReader usado para alimentar os dados XML no documento.

Exceções

XmlException

Há um erro de carregamento ou de análise no XML. Nesse caso, o documento permanece vazio.

Exemplos

O exemplo a seguir carrega o último nó do livro do books.xml arquivo no 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

O exemplo usa o arquivo , 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>

Comentários

Observação

O Load método sempre preserva um espaço em branco significativo. A PreserveWhitespace propriedade determina se o espaço em branco insignificante ou não, que é espaço em branco no conteúdo do elemento, é preservado. O padrão é false; o espaço em branco no conteúdo do elemento não é preservado.

Se o leitor estiver no estado inicial (ReadState =ReadState.Initial), Load consumirá todo o conteúdo do leitor e criará o DOM com base no que ele encontrar.

Se o leitor já estiver posicionado em algum nó em profundidade "n", esse método carregará esse nó e todos os irmãos subsequentes até a marca final que fecha a profundidade "n". Isso tem os seguintes resultados.

Se o nó atual e seus irmãos forem semelhantes aos seguintes:

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

Load gera uma exceção porque um documento não pode ter dois elementos de nível raiz. Se o nó atual e seus irmãos forem semelhantes aos seguintes:

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

Load é bem-sucedido, mas você tem uma árvore DOM incompleta porque não há nenhum elemento de nível raiz. Antes de salvar o documento, você deve adicionar um elemento de nível raiz, caso contrário Save , gerará uma exceção.

Se o leitor estiver posicionado em um nó folha inválido para o nível raiz de um documento, por exemplo, um nó de atributo ou espaço em branco, o leitor continuará a ler até ser posicionado em um nó que pode ser usado para a raiz. O documento começa a carregar no momento.

Se quiser que a validação ocorra, você poderá criar uma instância de validação XmlReader usando a XmlReaderSettings classe e o Create método . Para obter mais informações, consulte a seção de Comentários da página de referência XmlReader.

Esse método é uma extensão da Microsoft para o DOM (Modelo de Objeto de Documento).

Confira também

• ValidationEventArgs
• XmlSeverityType
• Schemas