XmlWriter.WriteEndElement Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Quando substituído em uma classe derivada, fecha um elemento e aciona o escopo de namespace correspondente.

C#

public abstract void WriteEndElement ();

Exceções

InvalidOperationException

Isso resulta em um documento XML inválido.

- ou -

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Exemplos

O exemplo a seguir usa os métodos e os WriteEndElement WriteFullEndElement métodos.

C#

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

     // Create a writer to write XML to the console.
     XmlWriterSettings settings = new XmlWriterSettings();
     settings.Indent = true;
     XmlWriter writer = XmlWriter.Create(Console.Out, settings);

     // Write the root element.
     writer.WriteStartElement("order");

     // Write an element with attributes.
     writer.WriteStartElement("item");
     writer.WriteAttributeString("date", "2/19/01");
     writer.WriteAttributeString("orderID", "136A5");

     // Write a full end element. Because this element has no
     // content, calling WriteEndElement would have written a
     // short end tag '/>'.
     writer.WriteFullEndElement();

     writer.WriteEndElement();

     // Write the XML to file and close the writer
     writer.Close();
  }
}

Comentários

Se o elemento não contiver conteúdo, uma marca de extremidade curta "/>" será gravada; caso contrário, uma marca de extremidade completa é gravada.

Nota

Quando você usa os XmlWriter métodos para gerar XML, os elementos e atributos não serão gravados até que você chame o Close método. Por exemplo, se você estiver usando o XmlWriter para preencher um XmlDocument, até fechar o XmlWriter, você não poderá observar os elementos e atributos escritos no documento de destino.

Para obter a versão assíncrona deste método, consulte WriteEndElementAsync.

Aplica-se a