XmlWriter.WriteEndElement Metod

Definition

Namnområde:
System.Xml
Sammansättningar:
System.Xml.dll, System.Xml.ReaderWriter.dll
Sammansättningar:
netstandard.dll, System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.dll
Sammansättning:
netstandard.dll
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs

När det åsidosätts i en härledd klass stänger ett element och visar motsvarande namnområdesomfång.

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

Undantag

InvalidOperationException

Detta resulterar i ett ogiltigt XML-dokument.

-eller-

En XmlWriter metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

Exempel

I följande exempel används WriteEndElement metoderna och WriteFullEndElement .

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

Kommentarer

Om elementet inte innehåller något innehåll skrivs en kort sluttagg "/>" . Annars skrivs en fullständig sluttagg.

Note

När du använder XmlWriter metoderna för att mata ut XML skrivs inte elementen och attributen Close förrän du anropar metoden. Om du till exempel använder XmlWriter för att fylla i en XmlDocument, tills du stänger XmlWriter, kommer du inte att kunna observera de skrivna elementen och attributen i måldokumentet.

Den asynkrona versionen av den här metoden finns i WriteEndElementAsync.

Gäller för