XmlWriter.WriteEndElement Methode

Definition

Namespace:
System.Xml
Assemblys:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblys:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Quelle:
XmlWriter.cs
Quelle:
XmlWriter.cs
Quelle:
XmlWriter.cs
Quelle:
XmlWriter.cs
Quelle:
XmlWriter.cs

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Element geschlossen und der entsprechende Namespacebereich eingeblendet.

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 InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

Beispiele

Im folgenden Beispiel werden die WriteEndElement Methoden und die WriteFullEndElement Methoden 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.

Note

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 zum Auffüllen eines XmlDocumentXmlWriters verwenden, bis Sie die XmlWriterZeichenfolge schließen, können Sie die geschriebenen Elemente und Attribute im Zieldokument nicht beobachten.

Die asynchrone Version dieser Methode finden Sie unter WriteEndElementAsync.

Gilt für: