XmlWriter.WriteEndElement Methode

Definitie

Wanneer deze wordt overschreven in een afgeleide klasse, sluit u één element en wordt het bijbehorende naamruimtebereik weergegeven.

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

Uitzonderingen

Dit resulteert in een ongeldig XML-document.

– of –

Er XmlWriter is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.

Voorbeelden

In het volgende voorbeeld worden de WriteEndElement en de WriteFullEndElement methoden gebruikt.

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

Opmerkingen

Als het element geen inhoud bevat, wordt er een korte eindtag '/>' geschreven. Anders wordt er een volledige eindtag geschreven.

Note

Wanneer u de XmlWriter methoden gebruikt om XML uit te voeren, worden de elementen en kenmerken pas geschreven als u de Close methode aanroept. Als u bijvoorbeeld de XmlWriter gebruikt om een XmlDocument, totdat u het XmlWritersluit, kunt u de geschreven elementen en kenmerken in het doeldocument niet observeren.

Zie voor de asynchrone versie van deze methode WriteEndElementAsync.

Van toepassing op