Przeczytaj w języku angielskim

Udostępnij za pośrednictwem

XmlWriter Klasa

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Xml
Zestaw:
System.Xml.ReaderWriter.dll
Zestaw:
System.Xml.dll
Zestaw:
netstandard.dll
Źródło:
XmlWriter.cs
Źródło:
XmlWriter.cs
Ź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.

C# 
public abstract class XmlWriter : IDisposable
C# 
public abstract class XmlWriter : IAsyncDisposable, IDisposable
C# 
public abstract class XmlWriter
Dziedziczenie
Object
XmlWriter
Pochodne
Implementuje
IDisposable IAsyncDisposable

Przykłady

Poniższy przykładowy kod pokazuje, jak używać asynchronicznego interfejsu API do generowania kodu XML.

C# 
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 uwagi dotyczące dodatkowego interfejsu API dla elementu XmlWriter.

Konstruktory

XmlWriter()

Inicjuje nowe wystąpienie klasy XmlWriter.

Właściwości

Settings

Pobiera obiekt XmlWriterSettings użyty do utworzenia tego wystąpienia XmlWriter.
WriteState

Po zastąpieniu w klasie pochodnej pobiera stan składnika zapisywania.
XmlLang

Po zastąpieniu w klasie pochodnej pobiera bieżący zakres xml:lang.
XmlSpace

Po zastąpieniu w klasie pochodnej pobiera XmlSpace reprezentujący bieżący zakres xml:space.

Metody

Close()

Gdy przesłonięta w klasie pochodnej, zamyka ten strumień i bazowy strumień.
Create(Stream)

Tworzy nowe wystąpienie XmlWriter przy użyciu określonego strumienia.
Create(Stream, XmlWriterSettings)

Tworzy nowe wystąpienie XmlWriter przy użyciu strumienia i obiektu XmlWriterSettings.
Create(String)

Tworzy nowe wystąpienie XmlWriter przy użyciu określonej nazwy pliku.
Create(String, XmlWriterSettings)

Tworzy nowe wystąpienie XmlWriter przy użyciu nazwy pliku i obiektu XmlWriterSettings.
Create(StringBuilder)

Tworzy nowe wystąpienie XmlWriter przy użyciu określonego StringBuilder.
Create(StringBuilder, XmlWriterSettings)

Tworzy nowe wystąpienie XmlWriter przy użyciu obiektów StringBuilder i XmlWriterSettings.
Create(TextWriter)

Tworzy nowe wystąpienie XmlWriter przy użyciu określonego TextWriter.
Create(TextWriter, XmlWriterSettings)

Tworzy nowe wystąpienie XmlWriter przy użyciu obiektów TextWriter i XmlWriterSettings.
Create(XmlWriter)

Tworzy nowe wystąpienie XmlWriter przy użyciu określonego obiektu XmlWriter.
Create(XmlWriter, XmlWriterSettings)

Tworzy nowe wystąpienie XmlWriter przy użyciu określonych obiektów XmlWriter i XmlWriterSettings.
Dispose()

Zwalnia wszystkie zasoby używane przez bieżące wystąpienie klasy XmlWriter.
Dispose(Boolean)

Zwalnia niezarządzane zasoby używane przez XmlWriter i opcjonalnie zwalnia zarządzane zasoby.
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, wydawaniem lub resetowaniem zasobów zarządzanych asynchronicznie.
Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.

(Odziedziczone po Object)
Flush()

Gdy przesłonięta w klasie pochodnej, opróżnia wszystkie elementy w buforze do bazowych strumieni, a także opróżnia bazowy strumień.
FlushAsync()

Asynchronicznie opróżnia dowolny element w buforze do bazowych strumieni, a także opróżnia bazowy strumień.
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.

(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 Object.

(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 na bieżącym położeniu w XmlReader.
WriteAttributesAsync(XmlReader, Boolean)

Asynchronicznie zapisuje wszystkie atrybuty znalezione w bieżącym położeniu w XmlReader.
WriteAttributeString(String, String)

Po zastąpieniu w klasie pochodnej zapisuje atrybut z określoną lokalną nazwą i wartością.
WriteAttributeString(String, String, String)

Po zastąpieniu w klasie pochodnej zapisuje atrybut z określoną lokalną nazwą, identyfikatorem URI przestrzeni nazw i wartością.
WriteAttributeString(String, String, String, String)

Po zastąpieniu 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)

Po zastąpieniu w klasie pochodnej zapisuje <! [CDATA[...]]> bloku zawierającego określony tekst.
WriteCDataAsync(String)

Asynchronicznie zapisuje <! [CDATA[...]]> bloku zawierającego określony tekst.
WriteCharEntity(Char)

Po zastąpieniu w klasie pochodnej wymusza generowanie jednostki znaku 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)

Po przesłonięciu w klasie pochodnej zapisuje tekst w jednym buforze naraz.
WriteCharsAsync(Char[], Int32, Int32)

Asynchronicznie zapisuje tekst po jednym buforze 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 z określoną nazwą i atrybutami opcjonalnymi.
WriteDocTypeAsync(String, String, String, String)

Asynchronicznie zapisuje deklarację DOCTYPE z określoną nazwą i atrybutami opcjonalnymi.
WriteElementString(String, String)

Zapisuje element o określonej nazwie lokalnej i wartości.
WriteElementString(String, String, String)

Zapisuje element z określoną lokalną nazwą, identyfikatorem 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 w klasie pochodnej zamyka poprzednie wywołanie WriteStartAttribute(String, String).
WriteEndAttributeAsync()

Asynchronicznie zamyka poprzednie wywołanie WriteStartAttribute(String, String).
WriteEndDocument()

Po zastąpieniu w klasie pochodnej zamyka wszystkie otwarte elementy lub atrybuty i umieszcza składnik zapisywania z powrotem w stanie Początkowy.
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)

Po zastąpieniu w klasie pochodnej 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ę, 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).
WriteNmToken(String)

Po zastąpieniu w klasie pochodnej 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).
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 zastąpieniu w klasie pochodnej kopiuje wszystko, od czytelnika do modułu zapisywania i przenosi czytelnika na początek następnego elementu równorzędnego.
WriteNode(XPathNavigator, Boolean)

Kopiuje wszystko, od obiektu XPathNavigator do składnika zapisywania. Pozycja XPathNavigator pozostaje 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 obiektu XPathNavigator do składnika zapisywania. Pozycja XPathNavigator pozostaje 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 nazwę kwalifikowaną przez przestrzeń nazw. Ta metoda wyszukuje prefiks, który znajduje się w zakresie dla danej przestrzeni nazw.
WriteQualifiedNameAsync(String, String)

Asynchronicznie zapisuje nazwę kwalifikowaną przez przestrzeń nazw. Ta metoda wyszukuje prefiks, który znajduje się w zakresie dla danej przestrzeni nazw.
WriteRaw(Char[], Int32, Int32)

Po przesłonięciu w klasie pochodnej ręcznie zapisuje nieprzetworzone znaczniki z buforu znaków.
WriteRaw(String)

Po przesłonięciu w klasie pochodnej ręcznie zapisuje nieprzetworzone znaczniki 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 z określoną lokalną nazwą i identyfikatorem 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()

Po zastąpieniu klasy pochodnej zapisuje deklarację XML w wersji "1.0".
WriteStartDocument(Boolean)

Po zastąpieniu w klasie pochodnej 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 zastąpieniu w klasie pochodnej zapisuje daną zawartość tekstową.
WriteStringAsync(String)

Asynchronicznie zapisuje daną zawartość tekstowa.
WriteSurrogateCharEntity(Char, Char)

Po zastąpieniu w klasie pochodnej 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)

Zapisuje wartość Boolean.
WriteValue(DateTime)

Zapisuje wartość DateTime.
WriteValue(DateTimeOffset)

Zapisuje wartość DateTimeOffset.
WriteValue(Decimal)

Zapisuje wartość Decimal.
WriteValue(Double)

Zapisuje wartość Double.
WriteValue(Int32)

Zapisuje wartość Int32.
WriteValue(Int64)

Zapisuje wartość Int64.
WriteValue(Object)

Zapisuje wartość obiektu.
WriteValue(Single)

Zapisuje liczbę zmiennoprzecinkową o pojedynczej precyzji.
WriteValue(String)

Zapisuje wartość String.
WriteWhitespace(String)

Po przesłonięciu w klasie pochodnej zapisuje podane białe znaki.
WriteWhitespaceAsync(String)

Asynchronicznie zapisuje podane białe znaki.

Jawne implementacje interfejsu

IDisposable.Dispose()

Aby uzyskać opis tego elementu członkowskiego, zobacz Dispose().

Metody rozszerzania

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, w jaki sposób będą wykonywane oczekiwania na zadania zwrócone z asynchronicznego jednorazowego użytku.

Dotyczy

Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Zobacz też