XmlWriter.WriteEndElement メソッド

定義

名前空間:
System.Xml
アセンブリ:
System.Xml.dll, System.Xml.ReaderWriter.dll
アセンブリ:
netstandard.dll, System.Xml.ReaderWriter.dll
アセンブリ:
System.Xml.ReaderWriter.dll
アセンブリ:
System.Xml.dll
アセンブリ:
netstandard.dll
ソース:
XmlWriter.cs
ソース:
XmlWriter.cs
ソース:
XmlWriter.cs
ソース:
XmlWriter.cs
ソース:
XmlWriter.cs

派生クラスでオーバーライドされると、1 つの要素を閉じ、対応する名前空間スコープをポップします。

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

例外

InvalidOperationException

これにより、XML ドキュメントが無効になります。

-又は-

前の非同期操作が完了する前に、 XmlWriter メソッドが呼び出されました。 この場合、"非同期操作は既に進行中です" というメッセージで InvalidOperationException がスローされます。

例

次の例では、 WriteEndElement メソッドと 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

注釈

要素にコンテンツが含まれていない場合は、短い終了タグ "/>" が書き込まれます。それ以外の場合は、完全終了タグが書き込まれます。

Note

XmlWriter メソッドを使用して XML を出力する場合、Close メソッドを呼び出すまで要素と属性は書き込まれません。 たとえば、XmlWriter を使用して XmlDocumentを設定する場合、 XmlWriterを閉じるまで、ターゲット ドキュメント内の書き込まれた要素と属性を観察することはできません。

このメソッドの非同期バージョンについては、 WriteEndElementAsyncを参照してください。

適用対象