XmlWriter Klasa

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

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 : 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

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

Klasa XmlWriter zapisuje dane XML w strumieniu, pliku, czytniku tekstu lub ciągu. Obsługuje on rekomendacje języka 1.0 (czwarta wersja) i przestrzenie nazw W3C Extensible Markup Language (XML) 1.0 (trzecia wersja).

XmlWriter Członkowie klasy umożliwiają:

• Sprawdź, czy znaki są znakami LEGAL XML, a nazwy elementów i atrybutów są prawidłowymi nazwami XML.

• Sprawdź, czy dokument XML jest dobrze sformułowany.

• Kodowanie bajtów binarnych jako Base64 lub BinHex i zapisywanie wynikowego tekstu.

• Przekazuj wartości przy użyciu typów środowiska uruchomieniowego języka wspólnego zamiast ciągów, aby uniknąć konieczności ręcznego wykonywania konwersji wartości.

• Napisz wiele dokumentów do jednego strumienia wyjściowego.

• Zapisuj prawidłowe nazwy, kwalifikowane nazwy i tokeny nazw.

W tej sekcji:

Tworzenie składnika zapisywania XML
Określanie formatu wyjściowego
Zgodność danych
Pisanie elementów
Pisanie atrybutów
Obsługa przestrzeni nazw
Zapisywanie wpisanych danych
Zamykanie składnika zapisywania XML
Programowanie asynchroniczne
Zagadnienia dotyczące zabezpieczeń

Tworzenie składnika zapisywania XML

Aby utworzyć XmlWriter wystąpienie, użyj XmlWriter.Create metody . Aby określić zestaw funkcji, które chcesz włączyć w składniku zapisywania XML, przekaż element XmlWriterSettings do Create metody . W przeciwnym razie są używane ustawienia domyślne. Create Aby uzyskać szczegółowe informacje, zobacz strony referencyjne.

Określanie formatu wyjściowego

Klasa XmlWriterSettings zawiera kilka właściwości, które kontrolują sposób XmlWriter formatowania danych wyjściowych:

Właściwość	Opis
Encoding	Określa kodowanie tekstu do użycia. Wartość domyślna to Encoding.UTF8.
Indent	Wskazuje, czy należy wciąć elementy. Wartość domyślna to false (bez wcięcia).
IndentChars	Określa ciąg znaków do użycia podczas wcięcia. Wartość domyślna to dwie spacje.
NewLineChars	Określa ciąg znaków do użycia w przypadku podziałów wierszy. Wartość domyślna to \r\n (powrót karetki, kanał informacyjny).
NewLineHandling	Określa sposób obsługi nowych znaków wiersza.
NewLineOnAttributes	Wskazuje, czy mają być zapisywane atrybuty w nowym wierszu. Indent należy ustawić wartość true na wartość w przypadku używania tej właściwości. Wartość domyślna to false.
OmitXmlDeclaration	Wskazuje, czy należy napisać deklarację XML. Wartość domyślna to false.

Właściwości Indent i IndentChars określają, jak nieistotne białe znaki są sformatowane. Na przykład do wcięcia węzłów elementów:

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = "\t";
XmlWriter writer = XmlWriter.Create("books.xml", settings);

Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("books.xml", settings)

Użyj polecenia NewLineOnAttributes , aby zapisać każdy atrybut w nowym wierszu z jednym dodatkowym poziomem wcięcia:

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.NewLineOnAttributes = true;
XmlWriter writer = XmlWriter.Create("books.xml", settings);

Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.NewLineOnAttributes = True
Dim writer As XmlWriter = XmlWriter.Create("books.xml", settings)

Zgodność danych

Składnik zapisywania XML używa dwóch właściwości klasy XmlWriterSettings , aby sprawdzić zgodność danych:

• Właściwość CheckCharacters instruuje składnik zapisywania XML, aby sprawdzać znaki i zgłaszać XmlException wyjątek, jeśli jakiekolwiek znaki znajdują się poza zakresem prawnym, zgodnie z definicją W3C.

• Właściwość ConformanceLevel konfiguruje składnik zapisywania XML w celu sprawdzenia, czy zapisywany strumień jest zgodny z regułami dla dobrze sformułowanego dokumentu XML 1.0 lub fragmentu dokumentu zgodnie z definicją W3C. Trzy poziomy zgodności opisano w poniższej tabeli. Wartość domyślna to Document. Aby uzyskać szczegółowe informacje, zobacz XmlWriterSettings.ConformanceLevel właściwość i wyliczenie System.Xml.ConformanceLevel .

  Poziom	Opis
  Document	Dane wyjściowe XML są zgodne z regułami dobrze sformułowanego dokumentu XML 1.0 i mogą być przetwarzane przez dowolny zgodny procesor.
  Fragment	Dane wyjściowe XML są zgodne z regułami dobrze sformułowanego fragmentu dokumentu XML 1.0.
  Auto	Składnik zapisywania XML określa, który poziom sprawdzania zgodności ma być stosowany (dokument lub fragment) na podstawie danych przychodzących.

Pisanie elementów

Za pomocą poniższych XmlWriter metod można pisać węzły elementów. Aby zapoznać się z przykładami, zobacz metody wymienione.

Zastosowanie	Działanie
WriteElementString	Napisz cały węzeł elementu, w tym wartość ciągu.
WriteStartElement	Aby napisać wartość elementu przy użyciu wielu wywołań metody. Można na przykład wywołać WriteValue funkcję zapisywania wartości typizowanej, WriteCharEntity w celu pisania jednostki znaku, WriteAttributeString pisania atrybutu lub pisania elementu podrzędnego. Jest to bardziej zaawansowana wersja WriteElementString metody. Aby zamknąć element, należy wywołać metodę WriteEndElement or WriteFullEndElement .
WriteNode	Aby skopiować węzeł elementu znajdujący się w bieżącej XmlReader pozycji obiektu lub XPathNavigator . Po wywołaniu kopiuje wszystko od obiektu źródłowego XmlWriter do wystąpienia.

Pisanie atrybutów

Za pomocą poniższych XmlWriter metod można zapisywać atrybuty w węzłach elementów. Metody te mogą również służyć do tworzenia deklaracji przestrzeni nazw w elemecie, zgodnie z opisem w następnej sekcji.

Zastosowanie	Działanie
WriteAttributeString	Aby napisać cały węzeł atrybutu, w tym wartość ciągu.
WriteStartAttribute	Aby zapisać wartość atrybutu przy użyciu wielu wywołań metody. Możesz na przykład wywołać WriteValue metodę zapisu wpisanej wartości. Jest to bardziej zaawansowana wersja WriteElementString metody. Aby zamknąć element, należy wywołać metodę WriteEndAttribute .
WriteAttributes	Aby skopiować wszystkie atrybuty znalezione w bieżącej XmlReader pozycji obiektu. Atrybuty zapisywane zależą od typu węzła, na który jest obecnie umieszczony czytnik: - W przypadku węzła atrybutu zapisuje bieżący atrybut, a następnie pozostałe atrybuty do momentu zamknięcia tagu elementu. — W przypadku węzła elementu zapisuje wszystkie atrybuty zawarte przez element. — W przypadku węzła deklaracji XML zapisuje wszystkie atrybuty w deklaracji. — Dla wszystkich innych typów węzłów metoda zgłasza wyjątek.

Obsługa przestrzeni nazw

Przestrzenie nazw służą do kwalifikowania nazw elementów i atrybutów w dokumencie XML. Prefiksy przestrzeni nazw kojarzą elementy i atrybuty z przestrzeniami nazw, które z kolei są skojarzone z odwołaniami identyfikatora URI. Przestrzenie nazw tworzą unikatowość nazw elementów i atrybutów w dokumencie XML.

Obiekt XmlWriter obsługuje stos przestrzeni nazw, który odpowiada wszystkim przestrzeniom nazw zdefiniowanym w bieżącym zakresie przestrzeni nazw. Podczas pisania elementów i atrybutów można używać przestrzeni nazw w następujący sposób:

• Zadeklaruj WriteAttributeString przestrzeń nazw ręcznie przy użyciu metody . Może to być przydatne, gdy wiesz, jak najlepiej zoptymalizować liczbę deklaracji przestrzeni nazw. Aby zapoznać się z przykładem, zobacz metodę WriteAttributeString(String, String, String, String) .

• Zastąpij bieżącą deklarację przestrzeni nazw nową przestrzenią nazw. W poniższym kodzie WriteAttributeString metoda zmienia identyfikator URI przestrzeni nazw dla prefiksu "x" z "123" na "abc".

  writer.WriteStartElement("x", "root", "123");
  writer.WriteStartElement("item");
  writer.WriteAttributeString("xmlns", "x", null, "abc");
  writer.WriteEndElement();
  writer.WriteEndElement();
  

  writer.WriteStartElement("x", "root", "123")
  writer.WriteStartElement("item")
  writer.WriteAttributeString("xmlns", "x", Nothing, "abc")
  writer.WriteEndElement()
  writer.WriteEndElement()
  

  Kod generuje następujący ciąg XML:

  <x:root xmlns:x="123">  
    <item xmlns:x="abc" />  
  </x:root>  
  

• Określ prefiks przestrzeni nazw podczas pisania atrybutów lub elementów. Wiele metod używanych do pisania elementów i atrybutów umożliwia wykonanie tej czynności. Na przykład WriteStartElement(String, String, String) metoda zapisuje tag startowy i kojarzy go z określoną przestrzenią nazw i prefiksem.

Zapisywanie wpisanych danych

Metoda WriteValue akceptuje obiekt środowiska uruchomieniowego języka wspólnego (CLR), konwertuje wartość wejściową na reprezentację ciągu zgodnie z regułami konwersji typów danych języka definicji schematu XML (XSD) i zapisuje ją przy użyciu WriteString metody . Jest to łatwiejsze niż użycie metod w XmlConvert klasie w celu przekonwertowania typowanych danych na wartość ciągu przed zapisaniem go.

Podczas zapisywania tekstu typowana wartość jest serializowana do tekstu przy użyciu XmlConvert reguł dla tego typu schematu.

Aby uzyskać domyślne typy danych XSD odpowiadające typom CLR, zobacz metodę WriteValue .

Można XmlWriter go również użyć do zapisu w magazynie danych XML. Na przykład XPathNavigator klasa może utworzyć obiekt w celu utworzenia XmlWriterXmlDocument węzłów dla obiektu. Jeśli magazyn danych zawiera dostępne informacje o schemacie, WriteValue metoda zgłasza wyjątek, jeśli próbujesz przekonwertować na typ, który nie jest dozwolony. Jeśli magazyn danych nie ma dostępnych informacji o schemacie, WriteValue metoda traktuje wszystkie wartości jako xsd:anySimpleType typ.

Zamykanie składnika zapisywania XML

Gdy używasz XmlWriter metod do wyprowadzania kodu XML, elementy i atrybuty nie są zapisywane, dopóki nie wywołasz Close metody. Jeśli na przykład używasz polecenia XmlWriter do wypełnienia XmlDocument obiektu, nie będzie można wyświetlić zapisanych elementów i atrybutów w dokumencie docelowym do momentu zamknięcia XmlWriter wystąpienia.

Programowanie asynchroniczne

XmlWriter Większość metod ma asynchroniczne odpowiedniki, które mają "asynchroniczne" na końcu nazw metod. Na przykład asynchroniczny odpowiednik parametru WriteAttributeString to WriteAttributeStringAsync.

WriteValue Dla metody, która nie ma asynchronicznego odpowiednika, przekonwertuj wartość zwracaną na ciąg i użyj WriteStringAsync metody .

Zagadnienia dotyczące bezpieczeństwa

Podczas pracy z klasą XmlWriter należy wziąć pod uwagę następujące kwestie:

• Wyjątki zgłaszane przez program XmlWriter mogą ujawniać informacje o ścieżce, których nie chcesz bąbelkować do aplikacji. Aplikacja musi przechwytywać wyjątki i przetwarzać je odpowiednio.

• XmlWriter nie weryfikuje żadnych danych przekazywanych do WriteDocType metody lub WriteRaw . Nie należy przekazywać dowolnych danych do tych metod.

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 przesłonięć w klasie pochodnej, zamyka ten strumień i bazowy strumień.
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()	Po zastąpieniu 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()	Type Pobiera wartość 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 Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
WriteAttributes(XmlReader, Boolean)	Po przesłonięcia w klasie pochodnej zapisuje wszystkie atrybuty znalezione w bieżącym położeniu 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 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 przesłonięciu 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)	Po zastąpieniu w klasie pochodnej wymusza generowanie jednostki znaku dla określonej wartości znaku Unicode.
WriteCharEntityAsync(Char)	Asynchronicznie wymusza generowanie jednostki znaku dla określonej wartości znaku Unicode.
WriteChars(Char[], Int32, Int32)	Podczas zastępowania w klasie pochodnej zapisuje tekst jeden bufor naraz.
WriteCharsAsync(Char[], Int32, Int32)	Asynchronicznie zapisuje tekst po jednym buforze naraz.
WriteComment(String)	Podczas zastępowania 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 lokalnej nazwie 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 WriteStartAttribute(String, String) wywołanie.
WriteEndAttributeAsync()	Asynchronicznie zamyka poprzednie WriteStartAttribute(String, String) wywołanie.
WriteEndDocument()	Po przesłonięcia w klasie pochodnej zamyka wszystkie otwarte elementy lub atrybuty i umieszcza składnik zapisywania z powrotem w stanie początkowym.
WriteEndDocumentAsync()	Asynchronicznie zamyka wszystkie otwarte elementy lub atrybuty i przywraca stan modułu zapisywania.
WriteEndElement()	Po przesłonięciu w klasie pochodnej zamyka jeden element i wyświetla odpowiadający mu zakres przestrzeni nazw.
WriteEndElementAsync()	Asynchronicznie zamyka jeden element i wyświetla odpowiedni zakres przestrzeni nazw.
WriteEntityRef(String)	Po zastąpieniu klasy pochodnej zapisuje odwołanie do jednostki jako &name;.
WriteEntityRefAsync(String)	Asynchronicznie zapisuje odwołanie do jednostki jako &name;.
WriteFullEndElement()	Po przesłonięciu w klasie pochodnej zamyka jeden element i wyświetla odpowiadający mu 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 to prawidłowy token 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 to prawidłowy token 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 modułu zapisającego i przenosi czytelnika na początek następnego elementu równorzędnego.
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 modułu zapisywania. Pozycja pozostaje XPathNavigator niezmieniona.
WriteProcessingInstruction(String, String)	Po przesłonięciu w klasie pochodnej zapisuje instrukcję przetwarzania z odstępem między nazwą a tekstem w następujący sposób: <?name text?>.
WriteProcessingInstructionAsync(String, String)	Asynchronicznie zapisuje instrukcję przetwarzania z odstępem między nazwą a tekstem w następujący sposób: <?name text?>.
WriteQualifiedName(String, String)	Po przesłonięciu 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 bufora 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()	Podczas zastępowania w klasie pochodnej zapisuje deklarację XML z wersją "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 z wersją "1.0".
WriteStartDocumentAsync(Boolean)	Asynchronicznie zapisuje deklarację XML z wersją "1.0" i atrybutem autonomicznym.
WriteStartElement(String)	Po przesłonięciu 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.

Jawne implementacje interfejsu

IDisposable.Dispose()

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

Metody rozszerzania

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje sposób oczekiwania na zadania zwracane z jednorazowego użytku asynchronicznego.

Zobacz też

• Dokumenty i dane XML