XmlDocument.LoadXml(String) Método

Definição

Namespace:

System.Xml

Assemblies:

System.Xml.dll, System.Xml.XmlDocument.dll

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.XmlDocument.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Carrega o documento XML da cadeia de caracteres especificada.

public:
 virtual void LoadXml(System::String ^ xml);

public virtual void LoadXml (string xml);

abstract member LoadXml : string -> unit
override this.LoadXml : string -> unit

Public Overridable Sub LoadXml (xml As String)

Parâmetros

xml

String

Cadeia de caracteres 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, o documento permanece vazio.

Exemplos

O exemplo a seguir carrega XML em um XmlDocument objeto e o salva em um arquivo.

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   
   // Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<item><name>wrench</name></item>" );
   
   // Add a price element.
   XmlElement^ newElem = doc->CreateElement( "price" );
   newElem->InnerText = "10.95";
   doc->DocumentElement->AppendChild( newElem );
   
   // Save the document to a file and auto-indent the output.
   XmlTextWriter^ writer = gcnew XmlTextWriter( "data.xml", nullptr );
   writer->Formatting = Formatting::Indented;
   doc->Save( writer );
}

using System;
using System.Xml;

public class Sample {

  public static void Main() {

    // Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<item><name>wrench</name></item>");

   // Add a price element.
   XmlElement newElem = doc.CreateElement("price");
   newElem.InnerText = "10.95";
   doc.DocumentElement.AppendChild(newElem);

   XmlWriterSettings settings = new XmlWriterSettings();
   settings.Indent = true;
   // Save the document to a file and auto-indent the output.
   XmlWriter writer = XmlWriter.Create("data.xml", settings);
    doc.Save(writer);
  }
}

Imports System.Xml

public class Sample 

  public shared sub Main() 
 
    ' Create the XmlDocument.
    Dim doc as XmlDocument = new XmlDocument()
    doc.LoadXml("<item><name>wrench</name></item>")

   ' Add a price element.
   Dim newElem as XmlElement = doc.CreateElement("price")
   newElem.InnerText = "10.95"
   doc.DocumentElement.AppendChild(newElem)

   Dim settings As New XmlWriterSettings()
   settings.Indent = True
   ' Save the document to a file and auto-indent the output.
   Dim writer As XmlWriter = XmlWriter.Create("data.xml", settings)
    doc.Save(writer)
  end sub
end class

Comentários

Por padrão, o LoadXml método não preserva espaço em branco ou espaço em branco significativo.

Esse método analisa DTDs (Definições de Tipo de Documento), mas não faz validação de esquema ou DTD. Se você quiser que a validação ocorra, você pode 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.

Se você quiser carregar de umStream, Stringou TextReaderXmlReader, use o método Load em vez desse método.

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

Confira também

• PreserveWhitespace