XmlWriter Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
-
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
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 |
XmlSpace |
Po przesłonięciu w klasie pochodnej pobiera wartość reprezentującą XmlSpace bieżący |
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 |
WriteBinHexAsync(Byte[], Int32, Int32) |
Asynchronicznie koduje określone bajty binarne jako |
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 |
WriteEntityRefAsync(String) |
Asynchronicznie zapisuje odwołanie do jednostki jako |
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. |
Jawne implementacje interfejsu
IDisposable.Dispose() |
Aby uzyskać opis tego elementu członkowskiego, zobacz Dispose(). |
Metody rozszerzania
ConfigureAwait(IAsyncDisposable, Boolean) |
Konfiguruje sposób oczekiwania na zadania zwracane z asynchronicznego jednorazowego wykonania. |
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla