XmlWriter.WriteEndElement Método

Definición

Cuando se invalida en una clase derivada, cierra un elemento y extrae el ámbito de espacio de nombres correspondiente.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

public:
 abstract void WriteEndElement();
public abstract void WriteEndElement ();
abstract member WriteEndElement : unit -> unit
Public MustOverride Sub WriteEndElement ()

Excepciones

Esto da como resultado un documento XML no válido.This results in an invalid XML document.

o bien-or-

Se llamó un método XmlWriter antes de que se termine una operación asincrónica anterior.An XmlWriter method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Ejemplos

En el ejemplo siguiente se utilizan los WriteEndElement WriteFullEndElement métodos y.The following example uses the WriteEndElement and the WriteFullEndElement methods.

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();
  }
}
Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
  Public Shared Sub Main()

     ' Create a writer to write XML to the console.
     Dim settings As XmlWriterSettings = new XmlWriterSettings()
     settings.Indent = true
     Dim writer As XmlWriter = 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()

    End Sub
End Class

Comentarios

Si el elemento no contiene contenido, se escribe una etiqueta de cierre corto "/>"; de lo contrario, se escribe una etiqueta de cierre completo.If the element contains no content, a short end tag "/>" is written; otherwise, a full end tag is written.

Nota

Cuando se usan los XmlWriter métodos para generar XML, los elementos y atributos no se escribirán hasta que se llame al Close método.When you use the XmlWriter methods to output XML, the elements and attributes will not be written until you call the Close method. Por ejemplo, si usa XmlWriter para rellenar un XmlDocument , hasta que cierre XmlWriter , no podrá observar los elementos y atributos escritos en el documento de destino.For example, if you are using the XmlWriter to populate an XmlDocument, until you close the XmlWriter, you will not be able to observe the written elements and attributes in the target document.

Para obtener la versión asincrónica de este método, vea WriteEndElementAsync .For the asynchronous version of this method, see WriteEndElementAsync.

Se aplica a