XmlWriter Třída

Definice

Představuje zapisovací modul, který nabízí rychlý dopředný způsob generování datových proudů nebo souborů obsahujících data XML bez mezipaměti.

public ref class XmlWriter abstract : IDisposable
public ref class XmlWriter abstract : IAsyncDisposable, IDisposable
public ref class XmlWriter abstract
public abstract class XmlWriter : IDisposable
public abstract class XmlWriter : IAsyncDisposable, IDisposable
public abstract class XmlWriter
type XmlWriter = class
    interface IDisposable
type XmlWriter = class
    interface IAsyncDisposable
    interface IDisposable
type XmlWriter = class
Public MustInherit Class XmlWriter
Implements IDisposable
Public MustInherit Class XmlWriter
Implements IAsyncDisposable, IDisposable
Public MustInherit Class XmlWriter
Dědičnost
XmlWriter
Odvozené
Implementuje

Příklady

Následující ukázkový kód ukazuje, jak pomocí asynchronního rozhraní API vygenerovat 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 najdete v tématu Doplňkové poznámky k rozhraní API pro XmlWriter.

Konstruktory

XmlWriter()

Inicializuje novou instanci XmlWriter třídy.

Vlastnosti

Settings

XmlWriterSettings Získá 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 obor.

XmlSpace

Při přepsání v odvozené třídě získá objekt XmlSpace představující aktuální xml:space obor.

Metody

Close()

Při přepsání v odvozené třídě zavře tento datový proud a podkladový datový proud.

Create(Stream)

Vytvoří novou XmlWriter instanci pomocí zadaného datového proudu.

Create(Stream, XmlWriterSettings)

Vytvoří novou XmlWriter instanci pomocí datového proudu a XmlWriterSettings objektu.

Create(String)

Vytvoří novou XmlWriter instanci pomocí zadaného názvu souboru.

Create(String, XmlWriterSettings)

Vytvoří novou XmlWriter instanci pomocí názvu souboru a XmlWriterSettings objektu.

Create(StringBuilder)

Vytvoří novou XmlWriter instanci pomocí zadané StringBuilderinstance .

Create(StringBuilder, XmlWriterSettings)

Vytvoří novou XmlWriter instanci pomocí StringBuilder objektů a XmlWriterSettings .

Create(TextWriter)

Vytvoří novou XmlWriter instanci pomocí zadané TextWriterinstance .

Create(TextWriter, XmlWriterSettings)

Vytvoří novou XmlWriter instanci pomocí TextWriter objektů a XmlWriterSettings .

Create(XmlWriter)

Vytvoří novou XmlWriter instanci pomocí zadaného XmlWriter objektu.

Create(XmlWriter, XmlWriterSettings)

Vytvoří novou XmlWriter instanci pomocí zadaných XmlWriter a XmlWriterSettings objektů.

Dispose()

Uvolní všechny prostředky používané aktuální instancí XmlWriter třídy.

Dispose(Boolean)

Uvolní nespravované prostředky používané XmlWriter nástrojem a volitelně uvolní spravované prostředky.

DisposeAsync()

Asynchronně provádí úlohy definované aplikací související s uvolněním, uvolněním nebo resetováním nespravovaných prostředků.

DisposeAsyncCore()

Asynchronně provádí úlohy definované aplikací související s uvolněním, uvolněním nebo resetováním spravovaných prostředků.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
Flush()

Při přepsání v odvozené třídě vyprázdní vše, co je ve vyrovnávací paměti, do podkladových datových proudů a také vyprázdní podkladový datový proud.

FlushAsync()

Asynchronně vyprázdní vše, 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í hashovací funkce.

(Zděděno od Object)
GetType()

Získá aktuální Type instanci.

(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ů pro identifikátor URI oboru názvů.

MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(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 objektu XmlReader.

WriteAttributesAsync(XmlReader, Boolean)

Asynchronně zapíše všechny atributy nalezené na aktuální pozici v objektu 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ě zakó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ě zakóduje zadané binární bajty jako BinHex a zapíše výsledný text.

WriteBinHexAsync(Byte[], Int32, Int32)

Asynchronně kó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ě zapíše <![ CDATA[...]]> blok obsahující zadaný text.

WriteCharEntity(Char)

Při přepsání v odvozené třídě vynutí generování znakové entity pro zadanou hodnotu znaku Unicode.

WriteCharEntityAsync(Char)

Asynchronně vynutí generování znakové entity pro zadanou hodnotu znaku Unicode.

WriteChars(Char[], Int32, Int32)

Při přepsání v odvozené třídě zapisuje text po jedné vyrovnávací paměti.

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 doctype deklarace 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 element 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í WriteStartAttribute(String, String) volání.

WriteEndDocument()

Při přepsání v odvozené třídě zavře všechny otevřené elementy nebo atributy a vrátí zapisovač zpět do počátečního stavu.

WriteEndDocumentAsync()

Asynchronně zavře všechny otevřené prvky nebo atributy a vrátí zapisovač zpět do stavu Zahájení.

WriteEndElement()

Při přepsání v odvozené třídě zavře jeden prvek a otevře 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 otevře 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 ujistěte se, ž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 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).

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šechno od čtenáře do zapisovače a přesune čtenáře na začátek dalšího sourozence.

WriteNode(XPathNavigator, Boolean)

Zkopíruje všechno z objektu XPathNavigator do zapisovače. Pozice zůstává XPathNavigator 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 sourozence.

WriteNodeAsync(XPathNavigator, Boolean)

Asynchronně zkopíruje vše z objektu XPathNavigator do zapisovače. Pozice zůstává XPathNavigator 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: <?name text?>.

WriteQualifiedName(String, String)

Při přepsání v odvozené třídě zapíše název kvalifikovaný pro obor názvů. Tato metoda vyhledá předponu, která je v oboru pro daný obor názvů.

WriteQualifiedNameAsync(String, String)

Asynchronně zapíše název kvalifikovaný pro obor 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ě zapíše nezpracované kódy ručně z vyrovnávací paměti znaků.

WriteRaw(String)

Při přepsání v odvozené třídě zapíše nezpracované značky ručně z řetězce.

WriteRawAsync(Char[], Int32, Int32)

Asynchronně zapíše nezpracované revize 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ý atribut.

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ě vygeneruje a zapíše entitu náhradního znaku pro dvojici náhradních znaků.

WriteValue(Boolean)

Zapíše Boolean hodnotu.

WriteValue(DateTime)

Zapíše DateTime hodnotu.

WriteValue(DateTimeOffset)

Zapíše DateTimeOffset hodnotu.

WriteValue(Decimal)

Zapíše Decimal hodnotu.

WriteValue(Double)

Zapíše Double hodnotu.

WriteValue(Int32)

Zapíše Int32 hodnotu.

WriteValue(Int64)

Zapíše Int64 hodnotu.

WriteValue(Object)

Zapíše hodnotu objektu.

WriteValue(Single)

Zapíše číslo s plovoucí desetinou čárkou s jednou přesností.

WriteValue(String)

Zapíše String hodnotu.

WriteWhitespace(String)

Při přepsání v odvozené třídě zapíše dané prázdné znaky.

WriteWhitespaceAsync(String)

Asynchronně zapíše danou mezeru.

Explicitní implementace rozhraní

IDisposable.Dispose()

Popis tohoto člena najdete v tématu Dispose().

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak se provádí čekání na úlohy vrácené z asynchronního jednorázového použití.

Platí pro

Viz také