XmlWriter.WriteEndElement Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Quelle:

XmlWriter.cs

Schließt beim Überschreiben in einer abgeleiteten Klasse ein Element und löst den entsprechenden Namespacebereich auf.

public:
 abstract void WriteEndElement();

public abstract void WriteEndElement ();

abstract member WriteEndElement : unit -> unit

Public MustOverride Sub WriteEndElement ()

Ausnahmen

InvalidOperationException

Dies führt zu einem ungültigen XML-Dokument.

- oder -

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Beispiele

Im folgenden Beispiel werden die WriteEndElement Methoden und WriteFullEndElement verwendet.

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

Hinweise

Wenn das Element keinen Inhalt enthält, wird ein kurzes Endtag "/>" geschrieben, andernfalls wird ein vollständiges Endtag geschrieben.

Hinweis

Wenn Sie die Methoden zum Ausgeben von XmlWriter XML verwenden, werden die Elemente und Attribute erst geschrieben, wenn Sie die Close -Methode aufrufen. Wenn Sie beispielsweise den XmlWriter verwenden, um einen XmlDocumentaufzufüllen, bis Sie die XmlWriterschließen, können Sie die geschriebenen Elemente und Attribute im Zieldokument nicht beobachten.

Die asynchrone Version dieser Methode finden Sie unter WriteEndElementAsync.