XmlNode.InnerXml Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define a marcação que representa apenas os nós filho desse nó.
public:
virtual property System::String ^ InnerXml { System::String ^ get(); void set(System::String ^ value); };
public virtual string InnerXml { get; set; }
member this.InnerXml : string with get, set
Public Overridable Property InnerXml As String
Valor da propriedade
A marcação dos nós filho desse nó, não incluindo atributos padrão.
Exceções
Definindo essa propriedade em um nó que não pode ter nós filho.
O XML especificado ao definir essa propriedade não está bem formado.
Exemplos
O exemplo a seguir compara as propriedades e InnerXml as InnerText propriedades.
using System;
using System.Xml;
public class Test {
public static void Main() {
XmlDocument doc = new XmlDocument();
doc.LoadXml("<root>"+
"<elem>some text<child/>more text</elem>" +
"</root>");
XmlNode elem = doc.DocumentElement.FirstChild;
// Note that InnerText does not include the markup.
Console.WriteLine("Display the InnerText of the element...");
Console.WriteLine( elem.InnerText );
// InnerXml includes the markup of the element.
Console.WriteLine("Display the InnerXml of the element...");
Console.WriteLine(elem.InnerXml);
// Set InnerText to a string that includes markup.
// The markup is escaped.
elem.InnerText = "Text containing <markup/> will have char(<) and char(>) escaped.";
Console.WriteLine( elem.OuterXml );
// Set InnerXml to a string that includes markup.
// The markup is not escaped.
elem.InnerXml = "Text containing <markup/>.";
Console.WriteLine( elem.OuterXml );
}
}
Imports System.Xml
public class Test
public shared sub Main()
Dim doc as XmlDocument = new XmlDocument()
doc.LoadXml("<root>"& _
"<elem>some text<child/>more text</elem>" & _
"</root>")
Dim elem as XmlNode = doc.DocumentElement.FirstChild
' Note that InnerText does not include the markup.
Console.WriteLine("Display the InnerText of the element...")
Console.WriteLine( elem.InnerText )
' InnerXml includes the markup of the element.
Console.WriteLine("Display the InnerXml of the element...")
Console.WriteLine(elem.InnerXml)
' Set InnerText to a string that includes markup.
' The markup is escaped.
elem.InnerText = "Text containing <markup/> will have char(<) and char(>) escaped."
Console.WriteLine( elem.OuterXml )
' Set InnerXml to a string that includes markup.
' The markup is not escaped.
elem.InnerXml = "Text containing <markup/>."
Console.WriteLine( elem.OuterXml )
end sub
end class
Comentários
A tentativa de definir essa propriedade de um nó que não pode ter nós filho, por exemplo, um nó de texto, gera uma exceção. Caso contrário, a configuração InnerXml substituirá os nós filho do nó pelo conteúdo analisado da cadeia de caracteres fornecida. A análise é feita no contexto atual do namespace.
Essa propriedade é uma extensão da Microsoft para o DOM (Document Object Model).
Observação
InnerXml não é uma maneira eficiente de modificar o DOM. Pode haver problemas de desempenho ao substituir nós complexos. É mais eficiente construir nós e usar métodos comoInsertBefore, e InsertAfterAppendChildRemoveChild modificar o documento Xml.