XmlWriter Klasa

Definicja

Reprezentuje moduł zapisujący, 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
XmlWriter
Pochodne
Implementuje

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 W3C Extensible Markup Language (XML) 1.0 (czwarta wersja) i przestrzenie nazw w zaleceniach XML 1.0 (wydanie trzecie).

Elementy członkowskie XmlWriter klasy umożliwiają:

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

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

  • Zakoduj bajty binarne jako Base64 lub BinHex i zapisz wynikowy tekst.

  • 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.

  • Zapisywanie wielu dokumentów w jednym strumieniu wyjściowym.

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

W tej sekcji:

Tworzenie składnika zapisywania XML
Określanie formatu danych wyjściowych
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 bezpieczeństwa

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ć dla modułu 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 danych wyjściowych

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 mają być wcięcie elementów. Wartość domyślna to false (bez wcięcia).
IndentChars Określa ciąg znaków, który ma być używany podczas wcięcia. Wartość domyślna to dwie spacje.
NewLineChars Określa ciąg znaków, który ma być używany dla podziałów wierszy. Wartość domyślna to \r\n (powrót karetki, podawanie wiersza).
NewLineHandling Określa sposób obsługi znaków nowego wiersza.
NewLineOnAttributes Wskazuje, czy należy zapisywać atrybuty w nowym wierszu. Indent należy ustawić wartość na true wartość w przypadku korzystania z 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 kontrolują sposób formatowania nieistotnego odstępu. Na przykład wcięcie 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 z XmlWriterSettings klasy, aby sprawdzić zgodność danych:

  • Właściwość instruuje składnik zapisywania CheckCharacters 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 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 System.Xml.ConformanceLevel wyliczenie.

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

Pisanie elementów

Do pisania węzłów elementów można użyć następujących XmlWriter metod. Przykłady można znaleźć na liście metod.

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 metodę zapisu wartości typizowanej, WriteCharEntity aby napisać jednostkę znaku, WriteAttributeString napisać atrybut lub napisać element podrzędny. 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 obiekt źródłowy 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, jak opisano w następnej sekcji.

Zastosowanie Działanie
WriteAttributeString Aby zapisać cały węzeł atrybutu, w tym wartość ciągu.
WriteStartAttribute Aby zapisać wartość atrybutu przy użyciu wielu wywołań metody. Na przykład można wywołać metodę WriteValue , aby napisać wartość typową. 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. Zapisane atrybuty zależą od typu węzła, na który obecnie znajduje się czytnik:

- W przypadku węzła atrybutu zapisuje bieżący atrybut, a następnie pozostałe atrybuty do momentu zamknięcia elementu tag.
— Dla węzła elementu zapisuje wszystkie atrybuty zawarte przez element .
- Dla węzła deklaracji XML zapisuje wszystkie atrybuty w deklaracji.
— W przypadku wszystkich innych typów węzłów metoda zgłasza wyjątek.

Obsługa przestrzeni nazw

Przestrzenie nazw są używane 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 do identyfikatora URI. Przestrzenie nazw tworzą unikatowość nazw elementów i atrybutów w dokumencie XML.

Obiekt XmlWriter obsługuje stos przestrzeni nazw odpowiadający 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:

  • Ręczne deklarowanie przestrzeni nazw przy użyciu WriteAttributeString 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 ich zapisaniem.

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

Aby uzyskać informacje o domyślnych typach danych XSD odpowiadających 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 XmlWriter celu utworzenia XmlDocument węzłów dla obiektu. Jeśli magazyn danych ma dostępne informacje o schemacie, WriteValue metoda zgłasza wyjątek w przypadku próby przekonwertowania na typ, który jest niedozwolony. 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 do momentu wywołania Close metody . Jeśli na przykład używasz XmlWriter polecenia w celu 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 elementu WriteAttributeString to WriteAttributeStringAsync.

W przypadku WriteValue 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 przekazywać do aplikacji. Aplikacja musi przechwytywać wyjątki i odpowiednio je przetwarzać.

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

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 zastąpieniu w klasie pochodnej pobiera stan składnika zapisywania.

XmlLang

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

XmlSpace

Po zastąpieniu w klasie pochodnej pobiera XmlSpace element reprezentujący 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)

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)

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 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 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ę, 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).

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 modułu 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)

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 początkowy 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)

Podczas zastępowania 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)

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 dane białe znaki.

WriteWhitespaceAsync(String)

Asynchronicznie zapisuje dane 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.

Dotyczy

Zobacz też