XmlWriter.Close Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestawy:

netstandard.dll, System.Xml.ReaderWriter.dll

Źródło:

XmlWriter.cs

Gdy przesłonięta w klasie pochodnej, zamyka ten strumień i bazowy strumień.

public:
 virtual void Close();

public virtual void Close();

abstract member Close : unit -> unit
override this.Close : unit -> unit

Public Overridable Sub Close ()

Wyjątki

InvalidOperationException

Wywołanie jest wykonywane w celu zapisania większej liczby danych wyjściowych po Close wywołaniu lub wynik tego wywołania jest nieprawidłowym dokumentem XML.

— lub —

Metoda XmlWriter została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Przykłady

Poniższy przykład zapisuje węzeł XML.

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;
     settings.OmitXmlDeclaration = true;
     XmlWriter writer = XmlWriter.Create(Console.Out, settings);

     // Write the book element.
     writer.WriteStartElement("book");

     // Write the title element.
     writer.WriteStartElement("title");
     writer.WriteString("Pride And Prejudice");
     writer.WriteEndElement();

     // Write the close tag for the root element.
     writer.WriteEndElement();

     // Write the XML 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
     settings.OmitXmlDeclaration = true
     Dim writer As XmlWriter = XmlWriter.Create(Console.Out, settings)

     ' Write the book element.
     writer.WriteStartElement("book")
        
     ' Write the title element.
     writer.WriteStartElement("title")
     writer.WriteString("Pride And Prejudice")
     writer.WriteEndElement()
        
     ' Write the close tag for the root element.
     writer.WriteEndElement()
        
     ' Write the XML and close the writer.
     writer.Close()

  End Sub
End Class

Uwagi

Wszystkie otwarte elementy lub atrybuty są automatycznie zamykane.

Note

W przypadku użycia XmlWriter metod do wyprowadzania kodu XML elementy i atrybuty nie zostaną zapisane do momentu wywołania Close metody . Jeśli na przykład używasz narzędzia XmlWriter do wypełnienia XmlDocumentelementu , dopóki nie zamkniesz XmlWriterelementu , nie będzie można obserwować zapisanych elementów i atrybutów w dokumencie docelowym.