XmlWriter Classe

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Origine:

XmlWriter.cs

Rappresenta un writer che fornisce un modo rapido, non memorizzato nella cache, forward-only per generare flussi o file che contengono 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 codice 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 supplementari sull'API per XmlWriter.

Costruttori

XmlWriter()

Inizializza una nuova istanza della classe XmlWriter.

Proprietà

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

Metodi

Close()	Quando sottoposto a override in una classe derivata, chiude questo flusso e il flusso sottostante.
Create(Stream)	Crea una nuova istanza di XmlWriter usando il flusso specificato.
Create(Stream, XmlWriterSettings)	Crea una nuova istanza di XmlWriter usando il flusso e l'oggetto XmlWriterSettings.
Create(String)	Crea una nuova istanza di XmlWriter usando il nome file specificato.
Create(String, XmlWriterSettings)	Crea una nuova istanza di XmlWriter usando il nome file e l'oggetto XmlWriterSettings.
Create(StringBuilder)	Crea una nuova istanza di XmlWriter utilizzando il StringBuilderspecificato.
Create(StringBuilder, XmlWriterSettings)	Crea una nuova istanza di XmlWriter utilizzando gli oggetti StringBuilder e XmlWriterSettings.
Create(TextWriter)	Crea una nuova istanza di XmlWriter utilizzando il TextWriterspecificato.
Create(TextWriter, XmlWriterSettings)	Crea una nuova istanza di XmlWriter utilizzando gli oggetti TextWriter e XmlWriterSettings.
Create(XmlWriter)	Crea una nuova istanza di 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 dal XmlWriter e, facoltativamente, rilascia le risorse gestite.
DisposeAsync()	Esegue attività definite dall'applicazione associate alla liberazione, al rilascio o alla reimpostazione asincrona delle risorse non gestite.
DisposeAsyncCore()	Esegue attività definite dall'applicazione associate alla liberazione, al rilascio o alla reimpostazione asincrona delle risorse gestite.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Flush()	Quando sottoposto a override in una classe derivata, scarica qualsiasi elemento nel buffer nei flussi sottostanti e scarica anche il flusso sottostante.
FlushAsync()	Scarica in modo asincrono qualsiasi elemento nel buffer nei flussi sottostanti e scarica anche il flusso sottostante.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
LookupPrefix(String)	Quando sottoposto a 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 del Objectcorrente. (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 trovati nella posizione corrente nella XmlReader.
WriteAttributesAsync(XmlReader, Boolean)	Scrive in modo asincrono tutti gli attributi trovati nella posizione corrente nel XmlReader.
WriteAttributeString(String, String)	In caso di override in una classe derivata, scrive l'attributo con il nome e il valore locali specificati.
WriteAttributeString(String, String, String)	In caso di 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)	In caso di 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 l'attributo con il prefisso, il nome locale, l'URI dello spazio dei nomi e il valore specificati.
WriteBase64(Byte[], Int32, Int32)	In caso di override in una classe derivata, codifica i byte binari specificati come Base64 e scrive il testo risultante.
WriteBase64Async(Byte[], Int32, Int32)	Codifica in modo asincrono i byte binari specificati come Base64 e scrive il testo risultante.
WriteBinHex(Byte[], Int32, Int32)	Quando sottoposto a override in una classe derivata, codifica i byte binari specificati come BinHex e scrive il testo risultante.
WriteBinHexAsync(Byte[], Int32, Int32)	Codifica in modo asincrono i byte binari specificati come BinHex e scrive il testo risultante.
WriteCData(String)	Quando sottoposto a override in una classe derivata, scrive un <! [CDATA[...]]> blocco contenente il testo specificato.
WriteCDataAsync(String)	Scrive in modo asincrono un <! [CDATA[...]]> blocco contenente il testo specificato.
WriteCharEntity(Char)	Quando sottoposto a override in una classe derivata, forza la generazione di un'entità carattere per il valore di carattere Unicode specificato.
WriteCharEntityAsync(Char)	Forza in modo asincrono la generazione di un'entità carattere per il valore di carattere Unicode specificato.
WriteChars(Char[], Int32, Int32)	Quando sottoposto a override in una classe derivata, scrive testo un buffer alla volta.
WriteCharsAsync(Char[], Int32, Int32)	Scrive in modo asincrono testo un buffer alla volta.
WriteComment(String)	Quando sottoposto a override in una classe derivata, scrive un commento <!--...--> contenente il testo specificato.
WriteCommentAsync(String)	Scrive in modo asincrono un commento <!--...--> contenente il testo specificato.
WriteDocType(String, String, String, String)	In caso di 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 e il valore locali 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 sottoposto a override in una classe derivata, chiude la chiamata WriteStartAttribute(String, String) precedente.
WriteEndAttributeAsync()	Chiude in modo asincrono la chiamata WriteStartAttribute(String, String) precedente.
WriteEndDocument()	Quando sottoposto a override in una classe derivata, chiude tutti gli elementi o gli attributi aperti e rimette il writer nello stato Start.
WriteEndDocumentAsync()	Chiude in modo asincrono tutti gli attributi o gli elementi aperti e riporta il writer nello stato Start.
WriteEndElement()	Quando sottoposto a override in una classe derivata, chiude un elemento e apre l'ambito dello spazio dei nomi corrispondente.
WriteEndElementAsync()	Chiude in modo asincrono un elemento e apre l'ambito dello spazio dei nomi corrispondente.
WriteEntityRef(String)	Quando sottoposto a override in una classe derivata, scrive un riferimento a un'entità come &name;.
WriteEntityRefAsync(String)	Scrive in modo asincrono un riferimento a un'entità come &name;.
WriteFullEndElement()	Quando sottoposto a override in una classe derivata, chiude un elemento e apre l'ambito dello spazio dei nomi corrispondente.
WriteFullEndElementAsync()	Chiude in modo asincrono un elemento e apre l'ambito dello spazio dei nomi corrispondente.
WriteName(String)	Quando sottoposto a 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, assicurandosi 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 sottoposto a 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, assicurandosi 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 tutti gli elementi dal lettore al writer e sposta il lettore all'inizio dell'elemento di pari livello successivo.
WriteNode(XPathNavigator, Boolean)	Copia tutti gli elementi dall'oggetto XPathNavigator al writer. La posizione del XPathNavigator rimane invariata.
WriteNodeAsync(XmlReader, Boolean)	Copia in modo asincrono tutti gli elementi dal lettore al writer e sposta il lettore all'inizio del successivo elemento di pari livello.
WriteNodeAsync(XPathNavigator, Boolean)	Copia in modo asincrono tutti gli elementi dall'oggetto XPathNavigator al writer. La posizione del XPathNavigator rimane 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 indicato di seguito: <?name text?>.
WriteProcessingInstructionAsync(String, String)	Scrive in modo asincrono un'istruzione di elaborazione con uno spazio tra il nome e il testo come indicato di seguito: <?name text?>.
WriteQualifiedName(String, String)	Quando sottoposto a override in una classe derivata, scrive il nome completo dello spazio dei nomi. Questo metodo cerca il 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 cerca il prefisso incluso nell'ambito dello spazio dei nomi specificato.
WriteRaw(Char[], Int32, Int32)	Quando sottoposto a override in una classe derivata, scrive manualmente markup non elaborato da un buffer di caratteri.
WriteRaw(String)	Quando ne viene eseguito l'override in una classe derivata, scrive manualmente markup non elaborato da una stringa.
WriteRawAsync(Char[], Int32, Int32)	Scrive manualmente markup non elaborato da un buffer di caratteri in modo asincrono.
WriteRawAsync(String)	Scrive manualmente il markup non elaborato in modo asincrono da 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 sottoposto a 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()	In caso di override in una classe derivata, scrive la dichiarazione XML con la versione "1.0".
WriteStartDocument(Boolean)	In caso di override in una classe derivata, scrive la dichiarazione XML con la versione "1.0" e l'attributo autonomo.
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 autonomo.
WriteStartElement(String)	Quando sottoposto a override in una classe derivata, scrive un tag iniziale con il nome locale specificato.
WriteStartElement(String, String)	Quando sottoposto a override in una classe derivata, scrive il tag iniziale specificato e lo associa allo spazio dei nomi specificato.
WriteStartElement(String, String, String)	Quando sottoposto a override in una classe derivata, scrive il tag iniziale specificato e lo associa allo spazio dei nomi e al prefisso specificati.
WriteStartElementAsync(String, String, String)	Scrive in modo asincrono il tag iniziale specificato e lo associa allo spazio dei nomi e al prefisso specificati.
WriteString(String)	Quando sottoposto a 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)	In caso di override in una classe derivata, genera e scrive l'entità carattere surrogato per la coppia di caratteri surrogati.
WriteSurrogateCharEntityAsync(Char, Char)	Genera e scrive in modo asincrono l'entità carattere surrogato 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 sottoposto a override in una classe derivata, scrive lo spazio vuoto specificato.
WriteWhitespaceAsync(String)	Scrive in modo asincrono lo spazio vuoto specificato.

Metodi di estensione

ConfigureAwait(IAsyncDisposable, Boolean)

Configura il modo in cui verranno eseguite le attese nelle attività restituite da un oggetto eliminabile asincrono.

Vedi anche

• documenti XML e dati