XmlWriter.WriteFullEndElement メソッド

定義

派生クラスでオーバーライドされると、1 つの要素を閉じ、対応する名前空間スコープをポップします。When overridden in a derived class, closes one element and pops the corresponding namespace scope.

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

例外

先行の非同期操作が完了する前に、XmlWriter メソッドが呼び出されました。An XmlWriter method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

次の例では、WriteEndElementWriteFullEndElement メソッドを使用します。The following example uses the WriteEndElement and the WriteFullEndElement methods.

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

注釈

このメソッドは、常に完全終了タグを書き込みます。This method always writes the full end tag. これは、完全終了タグを含める必要がある要素を処理する場合に便利です。This is useful when dealing with elements that must include a full end tag. たとえば、ブラウザーでは HTML スクリプトブロックが "</script >" で閉じられることが想定されています。For example, browsers expect HTML script blocks to be closed with "</script>".

このメソッドの非同期バージョンについては、「WriteFullEndElementAsync」を参照してください。For the asynchronous version of this method, see WriteFullEndElementAsync.

適用対象