XmlDocument.Load Método

Origem:

XmlDocument.cs

Origem:

XmlDocument.cs

Origem:

XmlDocument.cs

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

Exceções

Comentários

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

Origem:

XmlDocument.cs

Origem:

XmlDocument.cs

Origem:

XmlDocument.cs

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

Exceções

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

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

Origem:

XmlDocument.cs

Origem:

XmlDocument.cs

Origem:

XmlDocument.cs

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

Exceções

Comentários

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

Origem:

XmlDocument.cs

Origem:

XmlDocument.cs

Origem:

XmlDocument.cs

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

Exceções

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

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