XmlWriter.Close Metodo

Definizione

Quando sottoposto a override in una classe derivata, chiude questo flusso e il flusso sottostante.

public:
 abstract void Close();
public:
 virtual void Close();
public abstract void Close();
public virtual void Close();
abstract member Close : unit -> unit
abstract member Close : unit -> unit
override this.Close : unit -> unit
Public MustOverride Sub Close ()
Public Overridable Sub Close ()

Eccezioni

Viene effettuata una chiamata per scrivere più output dopo Close la chiamata o il risultato di questa chiamata è un documento XML non valido.

oppure

È stato chiamato un XmlWriter metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".

Esempio

Nell'esempio seguente viene scritto un nodo 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

Commenti

Tutti gli elementi o gli attributi lasciati aperti vengono chiusi automaticamente.

Note

Quando si usano i XmlWriter metodi per generare codice XML, gli elementi e gli attributi non verranno scritti fino a quando non si chiama il Close metodo . Ad esempio, se si usa XmlWriter per popolare un XmlDocumentoggetto , fino a quando non si chiude XmlWriter, non sarà possibile osservare gli elementi e gli attributi scritti nel documento di destinazione.

Si applica a