XmlDocument.Load Método

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.XmlDocument.dll
Assemblagens:
netstandard.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.XmlDocument.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll

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

Sobrecargas

Name Description
Load(Stream)

Carrega o documento XML a partir do fluxo especificado.
Load(TextReader)

Carrega o documento XML a partir do arquivo especificado TextReader.
Load(String)

Carrega o documento XML a partir da URL especificada.
Load(XmlReader)

Carrega o documento XML a partir do arquivo especificado XmlReader.

Load(Stream)

Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs

Carrega o documento XML a partir 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 contendo o documento XML para carregar.

Exceções

XmlException

Há um erro de carregamento ou análise no XML. Neste caso, a FileNotFoundException é elevado.

Observações

Note

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

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

Este método é uma extensão da Microsoft para o Document Object Model (DOM).

Este método deteta automaticamente o formato de string do XML de entrada (por exemplo, UTF-8, ANSI, e assim por diante). Se a sua aplicação precisa de saber qual a codificação usada para ler o fluxo, considere usar um XmlTextReader objeto para ler o fluxo e depois usar a XmlTextReader.Encoding propriedade para determinar a codificação. Se precisares de usar um XmlDocument objeto para trabalhar com XML, podes usar o XmlTextReader objeto para criar um. Para mais informações, consulte Leitura de Dados XML usando XPathDocument e XmlDocument.

Ver também

Aplica-se a

Load(TextReader)

Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs

Carrega o documento XML a partir do arquivo 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

Eles TextReader são usados para alimentar os dados XML no documento.

Exceções

XmlException

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

Exemplos

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

Observações

Note

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

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

Este método é uma extensão da Microsoft para o Document Object Model (DOM).

Ver também

Aplica-se a

Load(String)

Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs

Carrega o documento XML a partir 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 para o ficheiro que contém o documento XML para carregar. O URL pode ser um ficheiro local ou um URL HTTP (um endereço Web).

Exceções

XmlException

Há um erro de carregamento ou análise no XML. Neste caso, a FileNotFoundException é elevado.

ArgumentException

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

ArgumentNullException

filename é null.

PathTooLongException

O caminho especificado, nome do ficheiro ou ambos excedem o comprimento máximo definido pelo sistema.

DirectoryNotFoundException

O caminho especificado é inválido (por exemplo, está num disco não mapeado).

IOException

Ocorreu um erro de E/S durante a abertura do ficheiro.

UnauthorizedAccessException

filename especificou um ficheiro que é apenas leitura.

-ou-

Esta operação não é suportada na plataforma atual.

-ou-

filename especificava um diretório.

-ou-

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

FileNotFoundException

O ficheiro especificado filename não foi encontrado.

NotSupportedException

filename está num formato inválido.

SecurityException

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

Observações

Note

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

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

Este método é uma extensão da Microsoft para o Document Object Model (DOM).

Ver também

Aplica-se a

Load(XmlReader)

Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs

Carrega o documento XML a partir do arquivo 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

Eles XmlReader são usados para alimentar os dados XML no documento.

Exceções

XmlException

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

Exemplos

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

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

Observações

Note

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

Se o leitor estiver no estado inicial (ReadState =ReadState.Initial), Load consome todo o conteúdo do leitor e constrói o DOM a partir do que encontrar.

Se o leitor já estiver posicionado num nó na profundidade "n", este método carrega esse nó e todos os irmãos subsequentes até à tag final que fecha a profundidade "n". Isto tem os seguintes resultados.

Se o nó atual e os seus irmãos se apresentarem assim:

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

Load lança uma exceção porque um documento não pode ter dois elementos ao nível raiz. Se o nó atual e os seus irmãos se apresentarem assim:

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

Load tem sucesso, mas tens uma árvore DOM incompleta porque não há elemento ao nível da raiz. Antes de guardar o documento, deve adicionar um elemento ao nível raiz, caso contrário Save lançará uma exceção.

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

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

Este método é uma extensão da Microsoft para o Document Object Model (DOM).

Ver também

Aplica-se a