XmlWriter Classe

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Source:

XmlWriter.cs

Rappresenta un writer che fornisce un modo veloce, non in cache e di tipo forward-only per generare flussi o i file contenenti dati XML.

public ref class XmlWriter abstract : IAsyncDisposable, IDisposable

public abstract class XmlWriter : IAsyncDisposable, IDisposable

type XmlWriter = class
    interface IAsyncDisposable
    interface IDisposable

Public MustInherit Class XmlWriter
Implements IAsyncDisposable, IDisposable

Ereditarietà

Object

XmlWriter

Derivato

System.Xml.XmlDictionaryWriter

System.Xml.XmlTextWriter

System.Xml.Xsl.Runtime.XmlQueryOutput

Implementazioni

IDisposable IAsyncDisposable

Esempio

Il codice di esempio seguente illustra come usare l'API asincrona per generare XML.

async Task TestWriter(Stream stream)
{
    XmlWriterSettings settings = new XmlWriterSettings();
    settings.Async = true;

    using (XmlWriter writer = XmlWriter.Create(stream, settings)) {
        await writer.WriteStartElementAsync("pf", "root", "http://ns");
        await writer.WriteStartElementAsync(null, "sub", null);
        await writer.WriteAttributeStringAsync(null, "att", null, "val");
        await writer.WriteStringAsync("text");
        await writer.WriteEndElementAsync();
        await writer.WriteProcessingInstructionAsync("pName", "pValue");
        await writer.WriteCommentAsync("cValue");
        await writer.WriteCDataAsync("cdata value");
        await writer.WriteEndElementAsync();
        await writer.FlushAsync();
    }
}

Commenti

Per altre informazioni su questa API, vedere Osservazioni api supplementari per XmlWriter.

Costruttori

XmlWriter()

Inizializza una nuova istanza della classe XmlWriter.

Proprietà

Settings	Ottiene l'oggetto XmlWriterSettings usato per creare questa istanza di XmlWriter.
WriteState	Quando ne viene eseguito l'override in una classe derivata, ottiene lo stato del writer.
XmlLang	Quando ne viene eseguito l'override in una classe derivata, ottiene l'ambito xml:lang corrente.
XmlSpace	Quando sottoposto a override in una classe derivata, ottiene un'enumerazione XmlSpace che rappresenta l'ambito xml:space corrente.

Metodi

Close()	Quando ne viene eseguito l'override in una classe derivata, chiude questo flusso e quello sottostante.
Create(Stream)	Crea una nuova istanza di XmlWriter utilizzando il flusso specificato.
Create(Stream, XmlWriterSettings)	Crea una nuova istanza della classe XmlWriter utilizzando il flusso e l'oggetto XmlWriterSettings.
Create(String)	Crea una nuova istanza della classe XmlWriter utilizzando il nome file specificato.
Create(String, XmlWriterSettings)	Crea una nuova istanza di XmlWriter utilizzando il nome file e l'oggetto XmlWriterSettings.
Create(StringBuilder)	Crea una nuova istanza di XmlWriter utilizzando l'oggetto StringBuilder specificato.
Create(StringBuilder, XmlWriterSettings)	Crea una nuova istanza di XmlWriter utilizzando gli oggetti StringBuilder e XmlWriterSettings.
Create(TextWriter)	Crea una nuova istanza di XmlWriter utilizzando l'oggetto TextWriter specificato.
Create(TextWriter, XmlWriterSettings)	Crea una nuova istanza di XmlWriter utilizzando gli oggetti TextWriter e XmlWriterSettings.
Create(XmlWriter)	Crea una nuova istanza della classe XmlWriter utilizzando l'oggetto XmlWriter specificato.
Create(XmlWriter, XmlWriterSettings)	Crea una nuova istanza di XmlWriter utilizzando gli oggetti XmlWriter e XmlWriterSettings specificati.
Dispose()	Rilascia tutte le risorse usate dall'istanza corrente della classe XmlWriter.
Dispose(Boolean)	Rilascia le risorse non gestite usate da XmlWriter e, facoltativamente, le risorse gestite.
DisposeAsync()	Esegue attività definite dall'applicazione, ad esempio libera, rilascia o reimposta risorse non gestite in modo asincrono.
DisposeAsyncCore()	Esegue attività definite dall'applicazione, ad esempio libera, rilascia o reimposta risorse gestite in modo asincrono.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Flush()	Quando ne viene eseguito l'override in una classe derivata, scarica il contenuto del buffer nei flussi sottostanti e scarica anche il flusso sottostante.
FlushAsync()	Scarica in modo asincrono il contenuto del buffer nei flussi sottostanti e scarica anche il flusso sottostante.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
LookupPrefix(String)	Quando ne viene eseguito l'override in una classe derivata, restituisce il prefisso più vicino definito nell'ambito dello spazio dei nomi corrente per l'URI dello spazio dei nomi.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
WriteAttributes(XmlReader, Boolean)	Quando sottoposto a override in una classe derivata, scrive tutti gli attributi individuati in corrispondenza della posizione corrente nell'oggetto XmlReader.
WriteAttributesAsync(XmlReader, Boolean)	In modo asincrono scrive tutti gli attributi individuati in corrispondenza della posizione corrente nell'oggetto XmlReader.
WriteAttributeString(String, String)	Quando ne viene eseguito l'override in una classe derivata, scrive l'attributo con il nome locale e il valore specificati.
WriteAttributeString(String, String, String)	Quando ne viene eseguito l'override in una classe derivata, scrive un attributo con il nome locale, l'URI dello spazio dei nomi e il valore specificati.
WriteAttributeString(String, String, String, String)	Quando ne viene eseguito l'override in una classe derivata, scrive l'attributo con il prefisso, il nome locale, l'URI dello spazio dei nomi e il valore specificati.
WriteAttributeStringAsync(String, String, String, String)	Scrive in modo asincrono un attributo con il prefisso, il nome locale, l'URI dello spazio dei nomi e il valore specificati.
WriteBase64(Byte[], Int32, Int32)	Quando ne viene eseguito l'override in una classe derivata, codifica i byte binari specificati come valori Base64 e scrive il testo risultante.
WriteBase64Async(Byte[], Int32, Int32)	Codifica in modo asincrono i byte binari specificati come valori Base64 e scrive il testo risultante.
WriteBinHex(Byte[], Int32, Int32)	Quando sottoposto a override in una classe derivata, codifica i byte binari specificati come valori BinHex e scrive il testo risultante.
WriteBinHexAsync(Byte[], Int32, Int32)	Codifica in modo asincrono i byte binari specificati come valori BinHex e scrive il testo risultante.
WriteCData(String)	Quando sottoposto a override in una classe derivata, scrive un blocco <![CDATA[...]]> che contiene il testo specificato.
WriteCDataAsync(String)	Scrive in modo asincrono un blocco <![CDATA[...]]> che contiene il testo specificato.
WriteCharEntity(Char)	Quando ne viene eseguito l'override in una classe derivata, forza la generazione di un'entità carattere per il valore del carattere Unicode specificato.
WriteCharEntityAsync(Char)	Forza in modo asincrono la generazione di un'entità carattere per il valore del carattere Unicode specificato.
WriteChars(Char[], Int32, Int32)	Quando ne viene eseguito l'override in una classe derivata, scrive il testo in un buffer alla volta.
WriteCharsAsync(Char[], Int32, Int32)	Scrive in modo asincrono il testo in un buffer alla volta.
WriteComment(String)	Quando sottoposto a override in una classe derivata, scrive un commento <!--...--> che contiene il testo specificato.
WriteCommentAsync(String)	Scrive in modo asincrono un commento <!--...--> che contiene il testo specificato.
WriteDocType(String, String, String, String)	Quando ne viene eseguito l'override in una classe derivata, scrive la dichiarazione DOCTYPE con il nome e gli attributi facoltativi specificati.
WriteDocTypeAsync(String, String, String, String)	Scrive in modo asincrono la dichiarazione DOCTYPE con il nome e gli attributi facoltativi specificati.
WriteElementString(String, String)	Scrive un elemento con il nome locale e il valore specificati.
WriteElementString(String, String, String)	Scrive un elemento con il nome locale, l'URI dello spazio dei nomi e il valore specificati.
WriteElementString(String, String, String, String)	Scrive un elemento con il prefisso, il nome locale, l'URI dello spazio dei nomi e il valore specificati.
WriteElementStringAsync(String, String, String, String)	Scrive in modo asincrono un elemento con il prefisso, il nome locale, l'URI dello spazio dei nomi e il valore specificati.
WriteEndAttribute()	Quando se ne esegue l'override in una classe derivata, chiude la precedente chiamata al metodo WriteStartAttribute(String, String).
WriteEndAttributeAsync()	Chiude in modo asincrono la chiamata WriteStartAttribute(String, String) precedente.
WriteEndDocument()	Quando se ne esegue l'override in una classe derivata, chiude qualsiasi elemento o attributo aperto e riporta il writer allo stato di avvio.
WriteEndDocumentAsync()	Chiude in modo asincrono qualsiasi elemento o attributo aperto e riporta il writer allo stato di avvio.
WriteEndElement()	Quando ne viene eseguito l'override in una classe derivata, chiude un elemento e visualizza l'ambito dello spazio dei nomi corrispondente.
WriteEndElementAsync()	Chiude in modo asincrono un elemento e visualizza l'ambito dello spazio dei nomi corrispondente.
WriteEntityRef(String)	Se sottoposto a override in una classe derivata, scrive un riferimento a entità con formato &name;.
WriteEntityRefAsync(String)	In modo asincrono scrive un riferimento all'entità come &name;.
WriteFullEndElement()	Quando ne viene eseguito l'override in una classe derivata, chiude un elemento e visualizza l'ambito dello spazio dei nomi corrispondente.
WriteFullEndElementAsync()	Chiude in modo asincrono un elemento e visualizza l'ambito dello spazio dei nomi corrispondente.
WriteName(String)	Quando ne viene eseguito l'override in una classe derivata, scrive il nome specificato, verificando che sia un nome valido in base alla raccomandazione W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNameAsync(String)	Scrive in modo asincrono il nome specificato, verificando che sia un nome valido in base alla raccomandazione W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmToken(String)	Quando ne viene eseguito l'override in una classe derivata, scrive il nome specificato, verificando che sia un NmToken valido in base alla raccomandazione W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmTokenAsync(String)	Scrive in modo asincrono il nome specificato, verificando che sia un NmToken valido in base alla raccomandazione W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNode(XmlReader, Boolean)	Quando ne viene eseguito l'override in una classe derivata, copia tutto il contenuto del lettore nel writer e sposta il lettore all'inizio del successivo elemento di pari livello.
WriteNode(XPathNavigator, Boolean)	Copia tutti gli elementi dall'oggetto XPathNavigator nel writer. La posizione di XPathNavigator resta invariata.
WriteNodeAsync(XmlReader, Boolean)	Copia in modo asincrono tutto il contenuto del lettore nel writer e sposta il lettore sul successivo elemento di pari livello.
WriteNodeAsync(XPathNavigator, Boolean)	Copia in modo asincrono tutti gli elementi dall'oggetto XPathNavigator al writer. La posizione di XPathNavigator resta invariata.
WriteProcessingInstruction(String, String)	Quando sottoposto a override in una classe derivata, scrive un'istruzione di elaborazione con uno spazio tra il nome e il testo, come segue: <?name text?>.
WriteProcessingInstructionAsync(String, String)	Scrive in modo asincrono un'istruzione di elaborazione con uno spazio tra il nome e il testo, come segue: <?name text?>.
WriteQualifiedName(String, String)	Quando ne viene eseguito l'override in una classe derivata, scrive il nome completo dello spazio dei nomi. Questo metodo esegue la ricerca del prefisso incluso nell'ambito dello spazio dei nomi specificato.
WriteQualifiedNameAsync(String, String)	Scrive in modo asincrono il nome completo dello spazio dei nomi. Questo metodo esegue la ricerca del prefisso incluso nell'ambito dello spazio dei nomi specificato.
WriteRaw(Char[], Int32, Int32)	Quando ne viene eseguito l'override in una classe derivata, scrive manualmente markup non elaborato in base a un buffer di caratteri.
WriteRaw(String)	Quando ne viene eseguito l'override in una classe derivata, scrive manualmente markup non elaborato in base a una stringa.
WriteRawAsync(Char[], Int32, Int32)	Scrive manualmente in modo asincrono markup non elaborato in base a un buffer di caratteri.
WriteRawAsync(String)	Scrive manualmente in modo asincrono markup non elaborato in base a una stringa.
WriteStartAttribute(String)	Scrive l'inizio di un attributo con il nome locale specificato.
WriteStartAttribute(String, String)	Scrive l'inizio di un attributo con il nome locale e l'URI dello spazio dei nomi specificati.
WriteStartAttribute(String, String, String)	Quando ne viene eseguito l'override in una classe derivata, scrive l'inizio di un attributo con il prefisso, il nome locale e l'URI dello spazio dei nomi specificati.
WriteStartAttributeAsync(String, String, String)	Scrive in modo asincrono l'inizio di un attributo con il prefisso, il nome locale e l'URI dello spazio dei nomi specificati.
WriteStartDocument()	Quando ne viene eseguito l'override in una classe derivata, scrive la dichiarazione XML in base alla versione "1.0".
WriteStartDocument(Boolean)	Quando ne viene eseguito l'override in una classe derivata, scrive la dichiarazione XML in base alla versione "1.0" e all'attributo standalone.
WriteStartDocumentAsync()	Scrive in modo asincrono la dichiarazione XML con la versione "1.0".
WriteStartDocumentAsync(Boolean)	Scrive in modo asincrono la dichiarazione XML con la versione "1.0" e l'attributo standalone.
WriteStartElement(String)	Quando ne viene eseguito l'override in una classe derivata, scrive un tag di inizio con il nome locale specificato.
WriteStartElement(String, String)	Quando ne viene eseguito l'override in una classe derivata, scrive il tag di inizio specificato e lo associa allo spazio dei nomi indicato.
WriteStartElement(String, String, String)	Quando ne viene eseguito l'override in una classe derivata, scrive il tag di inizio specificato e lo associa allo spazio dei nomi e al prefisso specificati.
WriteStartElementAsync(String, String, String)	Scrive in modo asincrono il tag di inizio specificato e lo associa allo spazio dei nomi e al prefisso specificati.
WriteString(String)	Quando ne viene eseguito l'override in una classe derivata, scrive il contenuto di testo specificato.
WriteStringAsync(String)	Scrive in modo asincrono il contenuto di testo specificato.
WriteSurrogateCharEntity(Char, Char)	Quando ne viene eseguito l'override in una classe derivata, genera e scrive l'entità carattere surrogata per la coppia di caratteri surrogati.
WriteSurrogateCharEntityAsync(Char, Char)	Genera in modo asincrono e scrive l'entità carattere surrogata per la coppia di caratteri surrogati.
WriteValue(Boolean)	Scrive un valore Boolean.
WriteValue(DateTime)	Scrive un valore DateTime.
WriteValue(DateTimeOffset)	Scrive un valore DateTimeOffset.
WriteValue(Decimal)	Scrive un valore Decimal.
WriteValue(Double)	Scrive un valore Double.
WriteValue(Int32)	Scrive un valore Int32.
WriteValue(Int64)	Scrive un valore Int64.
WriteValue(Object)	Scrive il valore dell'oggetto.
WriteValue(Single)	Scrive un numero a virgola mobile e precisione singola.
WriteValue(String)	Scrive un valore String.
WriteWhitespace(String)	Quando ne viene eseguito l'override in una classe derivata, scrive lo spazio specificato.
WriteWhitespaceAsync(String)	Scrive in modo asincrono lo spazio vuoto specificato.

Metodi di estensione

ConfigureAwait(IAsyncDisposable, Boolean)

Consente di configurare la modalità di esecuzione delle espressioni await per le attività restituite da un elemento disposable asincrono.

Vedi anche

• Documenti e dati XML