XmlWriter.WriteEndElement Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:

System.Xml.dll

Bütünleştirilmiş Kod:

netstandard.dll

Türetilmiş bir sınıfta geçersiz kılındığında, bir öğeyi kapatır ve ilgili ad alanı kapsamını açar.

public:
 abstract void WriteEndElement();

public abstract void WriteEndElement ();

abstract member WriteEndElement : unit -> unit

Public MustOverride Sub WriteEndElement ()

Özel durumlar

InvalidOperationException

Bu, geçersiz bir XML belgesine neden olur.

-veya-

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Örnekler

Aşağıdaki örnekte ve WriteFullEndElement yöntemleri kullanılırWriteEndElement.

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

Açıklamalar

öğesi içerik içermiyorsa, "/>" kısa uç etiketi yazılır; aksi takdirde tam uç etiketi yazılır.

Not

XML çıktısı XmlWriter almak için yöntemlerini kullandığınızda, siz yöntemini çağırana Close kadar öğeler ve öznitelikler yazılmaz. Örneğin, bir öğesini doldurmak XmlDocumentiçin XmlWriter kullanıyorsanız, öğesini kapatana XmlWriterkadar hedef belgedeki yazılı öğeleri ve öznitelikleri gözlemleyemezsiniz.

Bu yöntemin zaman uyumsuz sürümü için bkz WriteEndElementAsync. .