XmlWriter Třída

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Zdroj:

XmlWriter.cs

Představuje zapisovač, který poskytuje rychlý, nepamětný, dopředný způsob generování datových proudů nebo souborů obsahujících data 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

Dědičnost

Object

XmlWriter

Odvozené

System.Xml.XmlDictionaryWriter

System.Xml.XmlTextWriter

System.Xml.Xsl.Runtime.XmlQueryOutput

Implementuje

IDisposable IAsyncDisposable

Příklady

Následující příklad kódu ukazuje, jak použít asynchronní rozhraní API ke generování 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();
    }
}

Poznámky

Další informace o tomto rozhraní API naleznete v tématu Doplňkové poznámky k rozhraní API pro XmlWriter.

Konstruktory

XmlWriter()

Inicializuje novou instanci XmlWriter třídy.

Vlastnosti

Settings	Získá XmlWriterSettings objekt použitý k vytvoření této XmlWriter instance.
WriteState	Při přepsání v odvozené třídě získá stav zapisovače.
XmlLang	Při přepsání v odvozené třídě získá aktuální xml:lang rozsah.
XmlSpace	Při přepsání v odvozené třídě získá XmlSpace představující aktuální xml:space rozsah.

Metody

Close()	Při přepsání v odvozené třídě zavře tento datový proud a základní datový proud.
Create(Stream)	Vytvoří novou instanci XmlWriter pomocí zadaného datového proudu.
Create(Stream, XmlWriterSettings)	Vytvoří novou instanci XmlWriter pomocí datového proudu a objektu XmlWriterSettings.
Create(String)	Vytvoří novou instanci XmlWriter pomocí zadaného názvu souboru.
Create(String, XmlWriterSettings)	Vytvoří novou instanci XmlWriter pomocí názvu souboru a objektu XmlWriterSettings.
Create(StringBuilder)	Vytvoří novou instanci XmlWriter pomocí zadaného StringBuilder.
Create(StringBuilder, XmlWriterSettings)	Vytvoří novou instanci XmlWriter pomocí objektů StringBuilder a XmlWriterSettings.
Create(TextWriter)	Vytvoří novou instanci XmlWriter pomocí zadaného TextWriter.
Create(TextWriter, XmlWriterSettings)	Vytvoří novou instanci XmlWriter pomocí objektů TextWriter a XmlWriterSettings.
Create(XmlWriter)	Vytvoří novou instanci XmlWriter pomocí zadaného objektu XmlWriter.
Create(XmlWriter, XmlWriterSettings)	Vytvoří novou instanci XmlWriter pomocí zadaných XmlWriter a XmlWriterSettings objektů.
Dispose()	Uvolní všechny prostředky používané aktuální instancí třídy XmlWriter.
Dispose(Boolean)	Uvolní nespravované prostředky používané XmlWriter a volitelně uvolní spravované prostředky.
DisposeAsync()	Provádí úlohy definované aplikací přidružené k uvolnění, uvolnění nebo resetování nespravovaných prostředků asynchronně.
DisposeAsyncCore()	Provádí úlohy definované aplikací přidružené k uvolnění, uvolnění nebo resetování spravovaných prostředků asynchronně.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
Flush()	Při přepsání v odvozené třídě vyprázdní cokoli, co je ve vyrovnávací paměti, do podkladových datových proudů a také vyprázdní základní datový proud.
FlushAsync()	Asynchronně vyprázdní cokoli, co je ve vyrovnávací paměti, do podkladových datových proudů a také vyprázdní podkladový datový proud.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
LookupPrefix(String)	Při přepsání v odvozené třídě vrátí nejbližší předponu definovanou v aktuálním oboru názvů identifikátoru URI oboru názvů.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
WriteAttributes(XmlReader, Boolean)	Při přepsání v odvozené třídě zapíše všechny atributy nalezené na aktuální pozici v XmlReader.
WriteAttributesAsync(XmlReader, Boolean)	Asynchronně zapíše všechny atributy nalezené na aktuální pozici v XmlReader.
WriteAttributeString(String, String)	Při přepsání v odvozené třídě zapíše atribut se zadaným místním názvem a hodnotou.
WriteAttributeString(String, String, String)	Při přepsání v odvozené třídě zapíše atribut se zadaným místním názvem, identifikátorem URI oboru názvů a hodnotou.
WriteAttributeString(String, String, String, String)	Při přepsání v odvozené třídě zapíše atribut se zadanou předponou, místním názvem, identifikátorem URI oboru názvů a hodnotou.
WriteAttributeStringAsync(String, String, String, String)	Asynchronně zapíše atribut se zadanou předponou, místním názvem, identifikátorem URI oboru názvů a hodnotou.
WriteBase64(Byte[], Int32, Int32)	Při přepsání v odvozené třídě kóduje zadané binární bajty jako Base64 a zapíše výsledný text.
WriteBase64Async(Byte[], Int32, Int32)	Asynchronně zakóduje zadané binární bajty jako Base64 a zapíše výsledný text.
WriteBinHex(Byte[], Int32, Int32)	Při přepsání v odvozené třídě kóduje zadané binární bajty jako BinHex a zapíše výsledný text.
WriteBinHexAsync(Byte[], Int32, Int32)	Asynchronně zakóduje zadané binární bajty jako BinHex a zapíše výsledný text.
WriteCData(String)	Při přepsání v odvozené třídě, zapíše <! [CDATA[...]]> blok obsahující zadaný text.
WriteCDataAsync(String)	Asynchronně zapisuje <! [CDATA[...]]> blok obsahující zadaný text.
WriteCharEntity(Char)	Při přepsání v odvozené třídě vynutí generování entity znaku pro zadanou hodnotu znaku Unicode.
WriteCharEntityAsync(Char)	Asynchronně vynutí generování entity znaku pro zadanou hodnotu znaku Unicode.
WriteChars(Char[], Int32, Int32)	Při přepsání v odvozené třídě zapíše text po jedné vyrovnávací paměti najednou.
WriteCharsAsync(Char[], Int32, Int32)	Asynchronně zapisuje text po jedné vyrovnávací paměti.
WriteComment(String)	Při přepsání v odvozené třídě zapíše komentář <!--...--> obsahující zadaný text.
WriteCommentAsync(String)	Asynchronně zapíše komentář <!--...--> obsahující zadaný text.
WriteDocType(String, String, String, String)	Při přepsání v odvozené třídě zapíše deklaraci DOCTYPE se zadaným názvem a volitelnými atributy.
WriteDocTypeAsync(String, String, String, String)	Asynchronně zapíše deklaraci DOCTYPE se zadaným názvem a volitelnými atributy.
WriteElementString(String, String)	Zapíše prvek se zadaným místním názvem a hodnotou.
WriteElementString(String, String, String)	Zapíše prvek se zadaným místním názvem, identifikátorem URI oboru názvů a hodnotou.
WriteElementString(String, String, String, String)	Zapíše prvek se zadanou předponou, místním názvem, identifikátorem URI oboru názvů a hodnotou.
WriteElementStringAsync(String, String, String, String)	Asynchronně zapíše prvek se zadanou předponou, místním názvem, identifikátorem URI oboru názvů a hodnotou.
WriteEndAttribute()	Při přepsání v odvozené třídě zavře předchozí WriteStartAttribute(String, String) volání.
WriteEndAttributeAsync()	Asynchronně zavře předchozí volání WriteStartAttribute(String, String).
WriteEndDocument()	Při přepsání v odvozené třídě zavře všechny otevřené elementy nebo atributy a vloží zapisovač zpět do stavu Start.
WriteEndDocumentAsync()	Asynchronně zavře všechny otevřené prvky nebo atributy a umístí zapisovač zpět do stavu Start.
WriteEndElement()	Při přepsání v odvozené třídě zavře jeden prvek a zobrazí odpovídající obor názvů.
WriteEndElementAsync()	Asynchronně zavře jeden prvek a zobrazí odpovídající obor názvů.
WriteEntityRef(String)	Při přepsání v odvozené třídě zapíše odkaz na entitu jako &name;.
WriteEntityRefAsync(String)	Asynchronně zapíše odkaz na entitu jako &name;.
WriteFullEndElement()	Při přepsání v odvozené třídě zavře jeden prvek a zobrazí odpovídající obor názvů.
WriteFullEndElementAsync()	Asynchronně zavře jeden prvek a zobrazí odpovídající obor názvů.
WriteName(String)	Při přepsání v odvozené třídě zapíše zadaný název a zajistí, že se jedná o platný název podle doporučení W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNameAsync(String)	Asynchronně zapíše zadaný název a zajistí, že se jedná o platný název podle doporučení W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmToken(String)	Při přepsání v odvozené třídě zapíše zadaný název, zajistí, že je to platný NmToken podle doporučení W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmTokenAsync(String)	Asynchronně zapíše zadaný název a zajistí, že se jedná o platný NmToken podle doporučení W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNode(XmlReader, Boolean)	Při přepsání v odvozené třídě zkopíruje vše od čtenáře do zapisovače a přesune čtenáře na začátek dalšího na stejné úrovni.
WriteNode(XPathNavigator, Boolean)	Zkopíruje všechno od objektu XPathNavigator do zapisovače. Pozice XPathNavigator zůstává beze změny.
WriteNodeAsync(XmlReader, Boolean)	Asynchronně zkopíruje všechno od čtenáře do zapisovače a přesune čtenáře na začátek dalšího na stejné straně.
WriteNodeAsync(XPathNavigator, Boolean)	Asynchronně zkopíruje vše od objektu XPathNavigator do zapisovače. Pozice XPathNavigator zůstává beze změny.
WriteProcessingInstruction(String, String)	Při přepsání v odvozené třídě zapíše instrukce zpracování s mezerou mezi názvem a textem následujícím způsobem: <?name text?>.
WriteProcessingInstructionAsync(String, String)	Asynchronně zapíše instrukce zpracování s mezerou mezi názvem a textem následujícím způsobem: <text ?name?>.
WriteQualifiedName(String, String)	Při přepsání v odvozené třídě zapíše kvalifikovaný název oboru názvů. Tato metoda vyhledá předponu, která je v oboru pro daný obor názvů.
WriteQualifiedNameAsync(String, String)	Asynchronně zapíše kvalifikovaný název oboru názvů. Tato metoda vyhledá předponu, která je v oboru pro daný obor názvů.
WriteRaw(Char[], Int32, Int32)	Při přepsání v odvozené třídě zapisuje nezpracované revize ručně z vyrovnávací paměti znaků.
WriteRaw(String)	Při přepsání v odvozené třídě zapíše nezpracované revize ručně z řetězce.
WriteRawAsync(Char[], Int32, Int32)	Asynchronně zapisuje nezpracované značky ručně z vyrovnávací paměti znaků.
WriteRawAsync(String)	Asynchronně zapisuje nezpracované značky ručně z řetězce.
WriteStartAttribute(String)	Zapíše začátek atributu se zadaným místním názvem.
WriteStartAttribute(String, String)	Zapíše začátek atributu se zadaným místním názvem a identifikátorem URI oboru názvů.
WriteStartAttribute(String, String, String)	Při přepsání v odvozené třídě zapíše začátek atributu se zadanou předponou, místním názvem a identifikátorem URI oboru názvů.
WriteStartAttributeAsync(String, String, String)	Asynchronně zapíše začátek atributu se zadanou předponou, místním názvem a identifikátorem URI oboru názvů.
WriteStartDocument()	Při přepsání v odvozené třídě zapíše deklaraci XML s verzí "1.0".
WriteStartDocument(Boolean)	Při přepsání v odvozené třídě zapíše deklaraci XML s verzí 1.0 a samostatným atributem.
WriteStartDocumentAsync()	Asynchronně zapíše deklaraci XML s verzí 1.0.
WriteStartDocumentAsync(Boolean)	Asynchronně zapíše deklaraci XML s verzí 1.0 a samostatným atributem.
WriteStartElement(String)	Při přepsání v odvozené třídě zapíše počáteční značku se zadaným místním názvem.
WriteStartElement(String, String)	Při přepsání v odvozené třídě zapíše zadanou počáteční značku a přidruží ji k danému oboru názvů.
WriteStartElement(String, String, String)	Při přepsání v odvozené třídě zapíše zadanou počáteční značku a přidruží ji k danému oboru názvů a předponě.
WriteStartElementAsync(String, String, String)	Asynchronně zapíše zadanou počáteční značku a přidruží ji k danému oboru názvů a předponě.
WriteString(String)	Při přepsání v odvozené třídě zapíše daný textový obsah.
WriteStringAsync(String)	Asynchronně zapíše daný textový obsah.
WriteSurrogateCharEntity(Char, Char)	Při přepsání v odvozené třídě vygeneruje a zapíše náhradní znak entitu pro dvojici náhradních znaků.
WriteSurrogateCharEntityAsync(Char, Char)	Asynchronně generuje a zapisuje náhradní znak entitu pro dvojici náhradních znaků.
WriteValue(Boolean)	Zapíše hodnotu Boolean.
WriteValue(DateTime)	Zapíše hodnotu DateTime.
WriteValue(DateTimeOffset)	Zapíše hodnotu DateTimeOffset.
WriteValue(Decimal)	Zapíše hodnotu Decimal.
WriteValue(Double)	Zapíše hodnotu Double.
WriteValue(Int32)	Zapíše hodnotu Int32.
WriteValue(Int64)	Zapíše hodnotu Int64.
WriteValue(Object)	Zapíše hodnotu objektu.
WriteValue(Single)	Zapíše jednopřesné číslo s plovoucí desetinnou čárkou.
WriteValue(String)	Zapíše hodnotu String.
WriteWhitespace(String)	Při přepsání v odvozené třídě zapíše dané prázdné znaky.
WriteWhitespaceAsync(String)	Asynchronně zapíše dané prázdné znaky.

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití.

Viz také

• dokumenty XML a datové