XmlWriter Klasa

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Źródło:

XmlWriter.cs

Reprezentuje moduł zapisywania, który zapewnia szybki, niebuforowany, tylko do przodu sposób generowania strumieni lub plików zawierających dane 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

Dziedziczenie

Object

XmlWriter

Pochodne

System.Xml.XmlDictionaryWriter

System.Xml.XmlTextWriter

System.Xml.Xsl.Runtime.XmlQueryOutput

Implementuje

IDisposable IAsyncDisposable

Przykłady

Poniższy przykładowy kod pokazuje, jak wygenerować kod XML przy użyciu asynchronicznego interfejsu API.

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();
    }
}

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz Dodatkowe uwagi dotyczące interfejsu API dla elementu XmlWriter.

Konstruktory

XmlWriter()

Inicjuje nowe wystąpienie klasy XmlWriter.

Właściwości

Settings	Pobiera obiekt użyty do utworzenia XmlWriterSettings tego XmlWriter wystąpienia.
WriteState	Po przesłonięciu w klasie pochodnej otrzymuje stan składnika zapisywania.
XmlLang	Po zastąpieniu w klasie pochodnej pobiera bieżący xml:lang zakres.
XmlSpace	Po przesłonięciu w klasie pochodnej pobiera wartość reprezentującą XmlSpace bieżący xml:space zakres.

Metody

Close()	Gdy zastąpisz klasę pochodną, zamyka ten strumień i strumień bazowy.
Create(Stream)	Tworzy nowe XmlWriter wystąpienie przy użyciu określonego strumienia.
Create(Stream, XmlWriterSettings)	Tworzy nowe XmlWriter wystąpienie przy użyciu strumienia i XmlWriterSettings obiektu.
Create(String)	Tworzy nowe XmlWriter wystąpienie przy użyciu określonej nazwy pliku.
Create(String, XmlWriterSettings)	Tworzy nowe XmlWriter wystąpienie przy użyciu nazwy pliku i XmlWriterSettings obiektu.
Create(StringBuilder)	Tworzy nowe XmlWriter wystąpienie przy użyciu określonego StringBuilderelementu .
Create(StringBuilder, XmlWriterSettings)	Tworzy nowe XmlWriter wystąpienie przy użyciu StringBuilder obiektów i XmlWriterSettings .
Create(TextWriter)	Tworzy nowe XmlWriter wystąpienie przy użyciu określonego TextWriterelementu .
Create(TextWriter, XmlWriterSettings)	Tworzy nowe XmlWriter wystąpienie przy użyciu TextWriter obiektów i XmlWriterSettings .
Create(XmlWriter)	Tworzy nowe XmlWriter wystąpienie przy użyciu określonego XmlWriter obiektu.
Create(XmlWriter, XmlWriterSettings)	Tworzy nowe XmlWriter wystąpienie przy użyciu określonych XmlWriter obiektów i XmlWriterSettings .
Dispose()	Zwalnia wszystkie zasoby używane przez bieżące wystąpienie klasy XmlWriter.
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element XmlWriter i opcjonalnie zwalnia zasoby zarządzane.
DisposeAsync()	Wykonuje zadania zdefiniowane przez aplikację skojarzone z zwalnianiem, zwalnianiem lub resetowaniem niezarządzanych zasobów asynchronicznie.
DisposeAsyncCore()	Wykonuje zadania zdefiniowane przez aplikację skojarzone z zwalnianiem, zwalnianiem lub resetowaniem zasobów zarządzanych asynchronicznie.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Flush()	Gdy zastąpisz klasę pochodną, opróżnia to, co znajduje się w buforze do źródłowych strumieni, a także opróżnia strumień bazowy.
FlushAsync()	Asynchronicznie opróżnia wszystko, co znajduje się w buforze do źródłowych strumieni, a także opróżnia strumień bazowy.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
LookupPrefix(String)	Po zastąpieniu w klasie pochodnej zwraca najbliższy prefiks zdefiniowany w bieżącym zakresie przestrzeni nazw dla identyfikatora URI przestrzeni nazw.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
WriteAttributes(XmlReader, Boolean)	Po zastąpieniu w klasie pochodnej zapisuje wszystkie atrybuty znalezione w bieżącej pozycji w obiekcie XmlReader.
WriteAttributesAsync(XmlReader, Boolean)	Asynchronicznie zapisuje wszystkie atrybuty znalezione w bieżącej pozycji w elemencie XmlReader.
WriteAttributeString(String, String)	Po zastąpieniu w klasie pochodnej zapisuje atrybut o określonej nazwie lokalnej i wartości.
WriteAttributeString(String, String, String)	Po zastąpieniu w klasie pochodnej zapisuje atrybut o określonej nazwie lokalnej, identyfikatorze URI przestrzeni nazw i wartości.
WriteAttributeString(String, String, String, String)	Podczas zastępowania w klasie pochodnej zapisuje atrybut z określonym prefiksem, nazwą lokalną, identyfikatorem URI przestrzeni nazw i wartością.
WriteAttributeStringAsync(String, String, String, String)	Asynchronicznie zapisuje atrybut z określonym prefiksem, nazwą lokalną, identyfikatorem URI przestrzeni nazw i wartością.
WriteBase64(Byte[], Int32, Int32)	Po zastąpieniu w klasie pochodnej koduje określone bajty binarne jako Base64 i zapisuje wynikowy tekst.
WriteBase64Async(Byte[], Int32, Int32)	Asynchronicznie koduje określone bajty binarne jako Base64 i zapisuje wynikowy tekst.
WriteBinHex(Byte[], Int32, Int32)	Po zastąpieniu w klasie pochodnej koduje określone bajty binarne jako BinHex i zapisuje wynikowy tekst.
WriteBinHexAsync(Byte[], Int32, Int32)	Asynchronicznie koduje określone bajty binarne jako BinHex i zapisuje wynikowy tekst.
WriteCData(String)	W przypadku zastąpienia w klasie pochodnej zapisuje element <![ CDATA[...]]> blok zawierający określony tekst.
WriteCDataAsync(String)	Asynchronicznie zapisuje element <![ CDATA[...]]> blok zawierający określony tekst.
WriteCharEntity(Char)	W przypadku przesłonięcia w klasie pochodnej wymusza generowanie jednostki znaków dla określonej wartości znaku Unicode.
WriteCharEntityAsync(Char)	Asynchronicznie wymusza generowanie jednostki znaków dla określonej wartości znaku Unicode.
WriteChars(Char[], Int32, Int32)	Gdy zastąpisz klasę pochodną, zapisuje tekst jeden bufor naraz.
WriteCharsAsync(Char[], Int32, Int32)	Asynchronicznie zapisuje tekst jeden bufor naraz.
WriteComment(String)	Po zastąpieniu w klasie pochodnej zapisuje komentarz <--...--> zawierający określony tekst.
WriteCommentAsync(String)	Asynchronicznie zapisuje komentarz <--...--> zawierający określony tekst.
WriteDocType(String, String, String, String)	Po zastąpieniu w klasie pochodnej zapisuje deklarację DOCTYPE o określonej nazwie i atrybutach opcjonalnych.
WriteDocTypeAsync(String, String, String, String)	Asynchronicznie zapisuje deklarację DOCTYPE o określonej nazwie i atrybutach opcjonalnych.
WriteElementString(String, String)	Zapisuje element o określonej nazwie lokalnej i wartości.
WriteElementString(String, String, String)	Zapisuje element o określonej nazwie lokalnej, identyfikatorze URI przestrzeni nazw i wartości.
WriteElementString(String, String, String, String)	Zapisuje element z określonym prefiksem, nazwą lokalną, identyfikatorem URI przestrzeni nazw i wartością.
WriteElementStringAsync(String, String, String, String)	Asynchronicznie zapisuje element z określonym prefiksem, nazwą lokalną, identyfikatorem URI przestrzeni nazw i wartością.
WriteEndAttribute()	Po zastąpieniu klasy pochodnej zamyka poprzednie WriteStartAttribute(String, String) wywołanie.
WriteEndAttributeAsync()	Asynchronicznie zamyka poprzednie WriteStartAttribute(String, String) wywołanie.
WriteEndDocument()	Gdy zastąpisz klasę pochodną, zamyka wszystkie otwarte elementy lub atrybuty i umieszcza składnik zapisywania z powrotem w stanie Start.
WriteEndDocumentAsync()	Asynchronicznie zamyka wszystkie otwarte elementy lub atrybuty i umieszcza składnik zapisywania z powrotem w stanie Start.
WriteEndElement()	Po zastąpieniu w klasie pochodnej zamyka jeden element i wyświetla odpowiedni zakres przestrzeni nazw.
WriteEndElementAsync()	Asynchronicznie zamyka jeden element i wyświetla odpowiedni zakres przestrzeni nazw.
WriteEntityRef(String)	Gdy zastąpisz klasę pochodną, zapisuje odwołanie do jednostki jako &name;.
WriteEntityRefAsync(String)	Asynchronicznie zapisuje odwołanie do jednostki jako &name;.
WriteFullEndElement()	Po zastąpieniu w klasie pochodnej zamyka jeden element i wyświetla odpowiedni zakres przestrzeni nazw.
WriteFullEndElementAsync()	Asynchronicznie zamyka jeden element i wyświetla odpowiedni zakres przestrzeni nazw.
WriteName(String)	Po zastąpieniu w klasie pochodnej zapisuje określoną nazwę, upewniając się, że jest prawidłową nazwą zgodnie z zaleceniem W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNameAsync(String)	Asynchronicznie zapisuje określoną nazwę, zapewniając, że jest prawidłową nazwą zgodnie z zaleceniem W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmToken(String)	W przypadku zastąpienia w klasie pochodnej zapisuje określoną nazwę, zapewniając, że jest prawidłowym elementem NmToken zgodnie z zaleceniem W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmTokenAsync(String)	Asynchronicznie zapisuje określoną nazwę, upewniając się, że jest prawidłowym elementem NmToken zgodnie z zaleceniem W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNode(XmlReader, Boolean)	Po przesłonięciu w klasie pochodnej kopiuje wszystko od czytelnika do pisarza i przenosi czytelnika na początek następnego rodzeństwa.
WriteNode(XPathNavigator, Boolean)	Kopiuje wszystko od XPathNavigator obiektu do składnika zapisywania. Pozycja pozostaje XPathNavigator niezmieniona.
WriteNodeAsync(XmlReader, Boolean)	Asynchronicznie kopiuje wszystko od czytelnika do pisarza i przenosi czytelnika na początek następnego rodzeństwa.
WriteNodeAsync(XPathNavigator, Boolean)	Asynchronicznie kopiuje wszystko od XPathNavigator obiektu do składnika zapisywania. Pozycja pozostaje XPathNavigator niezmieniona.
WriteProcessingInstruction(String, String)	Po zastąpieniu klasy pochodnej zapisuje instrukcję przetwarzania z spacją między nazwą a tekstem w następujący sposób: <?name text?>.
WriteProcessingInstructionAsync(String, String)	Asynchronicznie zapisuje instrukcję przetwarzania z spacją między nazwą a tekstem w następujący sposób: <?name text?>.
WriteQualifiedName(String, String)	Po zastąpieniu w klasie pochodnej zapisuje kwalifikowaną nazwę przestrzeni nazw. Ta metoda wyszukuje prefiks, który jest w zakresie dla danej przestrzeni nazw.
WriteQualifiedNameAsync(String, String)	Asynchronicznie zapisuje kwalifikowaną nazwę przestrzeni nazw. Ta metoda wyszukuje prefiks, który jest w zakresie dla danej przestrzeni nazw.
WriteRaw(Char[], Int32, Int32)	Gdy zastąpisz klasę pochodną, zapisuje nieprzetworzone znaczniki ręcznie z buforu znaków.
WriteRaw(String)	Gdy zastąpisz klasę pochodną, zapisuje nieprzetworzone znaczniki ręcznie z ciągu.
WriteRawAsync(Char[], Int32, Int32)	Asynchronicznie zapisuje nieprzetworzone znaczniki ręcznie z buforu znaków.
WriteRawAsync(String)	Asynchronicznie zapisuje nieprzetworzone znaczniki ręcznie z ciągu.
WriteStartAttribute(String)	Zapisuje początek atrybutu o określonej nazwie lokalnej.
WriteStartAttribute(String, String)	Zapisuje początek atrybutu o określonej lokalnej nazwie i identyfikatorze URI przestrzeni nazw.
WriteStartAttribute(String, String, String)	Po zastąpieniu w klasie pochodnej zapisuje początek atrybutu z określonym prefiksem, nazwą lokalną i identyfikatorem URI przestrzeni nazw.
WriteStartAttributeAsync(String, String, String)	Asynchronicznie zapisuje początek atrybutu z określonym prefiksem, nazwą lokalną i identyfikatorem URI przestrzeni nazw.
WriteStartDocument()	Gdy zastąpisz klasę pochodną, zapisuje deklarację XML w wersji "1.0".
WriteStartDocument(Boolean)	Gdy zastąpisz klasę pochodną, zapisuje deklarację XML z wersją "1.0" i atrybutem autonomicznym.
WriteStartDocumentAsync()	Asynchronicznie zapisuje deklarację XML w wersji "1.0".
WriteStartDocumentAsync(Boolean)	Asynchronicznie zapisuje deklarację XML z wersją "1.0" i atrybutem autonomicznym.
WriteStartElement(String)	Po zastąpieniu w klasie pochodnej zapisuje tag startowy o określonej nazwie lokalnej.
WriteStartElement(String, String)	Po zastąpieniu w klasie pochodnej zapisuje określony tag startowy i kojarzy go z daną przestrzenią nazw.
WriteStartElement(String, String, String)	Po zastąpieniu w klasie pochodnej zapisuje określony tag startowy i kojarzy go z daną przestrzenią nazw i prefiksem.
WriteStartElementAsync(String, String, String)	Asynchronicznie zapisuje określony tag startowy i kojarzy go z daną przestrzenią nazw i prefiksem.
WriteString(String)	Po przesłonięciu w klasie pochodnej zapisuje daną zawartość tekstową.
WriteStringAsync(String)	Asynchronicznie zapisuje daną zawartość tekstowa.
WriteSurrogateCharEntity(Char, Char)	Gdy zastąpisz klasę pochodną, generuje i zapisuje jednostkę znaku zastępczego dla pary znaków zastępczych.
WriteSurrogateCharEntityAsync(Char, Char)	Asynchronicznie generuje i zapisuje jednostkę znaku zastępczego dla pary znaków zastępczych.
WriteValue(Boolean)	Boolean Zapisuje wartość.
WriteValue(DateTime)	DateTime Zapisuje wartość.
WriteValue(DateTimeOffset)	DateTimeOffset Zapisuje wartość.
WriteValue(Decimal)	Decimal Zapisuje wartość.
WriteValue(Double)	Double Zapisuje wartość.
WriteValue(Int32)	Int32 Zapisuje wartość.
WriteValue(Int64)	Int64 Zapisuje wartość.
WriteValue(Object)	Zapisuje wartość obiektu.
WriteValue(Single)	Zapisuje liczbę zmiennoprzecinkową o pojedynczej precyzji.
WriteValue(String)	String Zapisuje wartość.
WriteWhitespace(String)	Po przesłonięciu w klasie pochodnej zapisuje podane białe znaki.
WriteWhitespaceAsync(String)	Asynchronicznie zapisuje podane białe znaki.

Metody rozszerzania

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje sposób oczekiwania na zadania zwracane z asynchronicznego jednorazowego wykonania.

Zobacz też

• Dokumenty i dane XML