XmlWriter Klasa

Definicja

Reprezentuje składnik zapisywania, który zapewnia szybki, niebuforowany, tylko do przodu sposób generowania strumieni lub plików, które zawierają dane XML.Represents a writer that provides a fast, non-cached, forward-only way to generate streams or files that contain XML data.

public ref class XmlWriter abstract : IDisposable
public abstract class XmlWriter : IDisposable
type XmlWriter = class
    interface IDisposable
Public MustInherit Class XmlWriter
Implements IDisposable
Dziedziczenie
XmlWriter
Pochodne
Implementuje

Przykłady

Poniższy przykładowy kod pokazuje, jak używać asynchronicznego interfejsu API do generowania kodu XML.The following example code shows how to use the asynchronous API to generate XML.

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

XmlWriter Klasa zapisuje dane XML do strumienia, pliku, czytnika tekstu lub ciągu.The XmlWriter class writes XML data to a stream, file, text reader, or string. Obsługuje ona XML W3C (XML) 1,0 (czwarte wersje) i przestrzenie nazw w XML 1,0 (wydanie trzecie) .It supports the W3C Extensible Markup Language (XML) 1.0 (fourth edition) and Namespaces in XML 1.0 (third edition) recommendations.

Członkowie XmlWriter klasy umożliwiają:The members of the XmlWriter class enable you to:

  • Sprawdź, czy znaki są dozwolonymi znakami XML i czy nazwy elementów i atrybutów są prawidłowymi nazwami XML.Verify that the characters are legal XML characters and that element and attribute names are valid XML names.

  • Sprawdź, czy dokument XML jest poprawnie sformułowany.Verify that the XML document is well-formed.

  • Koduj bajty binarne jako base64 lub BinHex i napisz otrzymany tekst.Encode binary bytes as Base64 or BinHex, and write out the resulting text.

  • 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.Pass values by using common language runtime types instead of strings, to avoid having to manually perform value conversions.

  • Zapisuj wiele dokumentów w jednym strumieniu wyjściowym.Write multiple documents to one output stream.

  • Zapisuj prawidłowe nazwy, nazwy kwalifikowane i tokeny nazw.Write valid names, qualified names, and name tokens.

W tej sekcji:In this section:

Tworzenie składnika zapisywania XML Creating an XML writer
Określanie formatu danych wyjściowych Specifying the output format
Zgodność danych Data conformance
Pisanie elementów Writing elements
Pisanie atrybutów Writing attributes
Obsługa przestrzeni nazw Handling namespaces
Zapisywanie danych wpisanych Writing typed data
Zamykanie składnika zapisywania XML Closing the XML writer
Programowanie asynchroniczne Asynchronous programming
Zagadnienia dotyczące bezpieczeństwaSecurity considerations

Tworzenie składnika zapisywania XMLCreating an XML writer

Aby utworzyć XmlWriter wystąpienie, XmlWriter.Create Użyj metody.To create an XmlWriter instance, use the XmlWriter.Create method. Aby określić zestaw funkcji, które mają być włączone w składniku zapisywania XML, Przekaż XmlWriterSettings Create metodę.To specify the set of features you want to enable on the XML writer, pass an XmlWriterSettings to the Create method. W przeciwnym razie używane są ustawienia domyślne.Otherwise, default settings are used. Szczegóły można znaleźć na stronach referencyjnych.CreateSee the Create reference pages for details.

Określanie formatu danych wyjściowychSpecifying the output format

Klasa zawiera kilka właściwości, które kontrolują XmlWriter sposób formatowania danych wyjściowych: XmlWriterSettingsThe XmlWriterSettings class includes several properties that control how XmlWriter output is formatted:

WłaściwośćProperty OpisDescription
Encoding Określa kodowanie tekstu, które ma być używane.Specifies the text encoding to use. Wartość domyślna to Encoding.UTF8.The default is Encoding.UTF8.
Indent Wskazuje, czy mają być Wcięte elementy.Indicates whether to indent elements. Wartość domyślna to false (bez wcięć).The default is false (no indentation).
IndentChars Określa ciąg znaków, który ma być używany podczas tworzenia wcięcia.Specifies the character string to use when indenting. Wartość domyślna to dwie spacje.The default is two spaces.
NewLineChars Określa ciąg znaków, który ma być używany dla podziałów wierszy.Specifies the character string to use for line breaks. Wartość domyślna to \r\n (znak powrotu karetki, wiersz wysuwu wiersza).The default is \r\n (carriage return, line feed).
NewLineHandling Określa sposób obsługi znaków nowego wiersza.Specifies how to handle newline characters.
NewLineOnAttributes Wskazuje, czy atrybuty mają być zapisywane w nowym wierszu.Indicates whether to write attributes on a new line. Indentnależy ustawić wartość true przy użyciu tej właściwości.Indent should be set to true when using this property. Wartość domyślna to false.The default is false.
OmitXmlDeclaration Wskazuje, czy należy napisać deklarację XML.Indicates whether to write an XML declaration. Wartość domyślna to false.The default is false.

Właściwości Indent i IndentChars kontrolują sposób, w jaki jest sformatowany nieznaczący biały znak.The Indent and IndentChars properties control how insignificant white space is formatted. Na przykład, aby wciąć węzły elementu:For example, to indent element nodes:

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, NewLineOnAttributes aby napisać każdy atrybut w nowym wierszu o jednym dodatkowym poziomie wcięcia:Use the NewLineOnAttributes to write each attribute on a new line with one extra level of indentation:

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ść danychData conformance

Składnik zapisywania XML używa dwóch właściwości z XmlWriterSettings klasy do sprawdzania zgodności danych:An XML writer uses two properties from the XmlWriterSettings class to check for data conformance:

  • Właściwość instruuje składnik zapisywania XML, aby sprawdzał znaki i XmlException zgłaszać wyjątek, jeśli jakiekolwiek znaki wykraczają poza dozwolony zakres, zgodnie z definicją W3C. CheckCharactersThe CheckCharacters property instructs the XML writer to check characters and throw an XmlException exception if any characters are outside the legal range, as defined by the W3C.

  • ConformanceLevel Właściwość konfiguruje składnik zapisywania XML, aby sprawdzić, czy zapisany strumień jest zgodny z regułami dla poprawnie sformułowanego dokumentu XML 1,0 lub fragment dokumentu, zgodnie z definicją W3C.The ConformanceLevel property configures the XML writer to check that the stream being written complies with the rules for a well-formed XML 1.0 document or document fragment, as defined by the W3C. Trzy poziomy zgodności są opisane w poniższej tabeli.The three conformance levels are described in the following table. Wartość domyślna to Document.The default is Document. Aby uzyskać szczegółowe informacje, XmlWriterSettings.ConformanceLevel Zobacz Właściwość System.Xml.ConformanceLevel i Wyliczenie.For details, see the XmlWriterSettings.ConformanceLevel property and the System.Xml.ConformanceLevel enumeration.

    PoziomLevel OpisDescription
    Document Dane wyjściowe XML są zgodne z regułami dla poprawnie sformułowanego dokumentu XML 1,0 i mogą być przetwarzane przez dowolny Procesor zgodny.The XML output conforms to the rules for a well-formed XML 1.0 document and can be processed by any conforming processor.
    Fragment Dane wyjściowe XML są zgodne z regułami dla poprawnie sformułowanego fragmentu dokumentu XML 1,0.The XML output conforms to the rules for a well-formed XML 1.0 document fragment.
    Auto Składnik zapisywania XML określa, który poziom sprawdzania zgodności ma być stosowany (dokument lub fragment) na podstawie danych przychodzących.The XML writer determines which level of conformation checking to apply (document or fragment) based on the incoming data.

Pisanie elementówWriting elements

Aby napisać węzły elementów, XmlWriter można użyć następujących metod.You can use the following XmlWriter methods to write element nodes. Aby zapoznać się z przykładami, zobacz listę metod.For examples, see the methods listed.

ZastosowanieUse ZadanieTo
WriteElementString Napisz cały węzeł elementu, łącznie z wartością ciągu.Write an entire element node, including a string value.
WriteStartElement Aby napisać wartość elementu przy użyciu wielu wywołań metod.To write an element value by using multiple method calls. Na przykład można wywołać WriteValue , aby napisać wartość typu, WriteCharEntity aby napisać jednostkę znaku, WriteAttributeString napisać atrybut lub można napisać element podrzędny.For example, you can call WriteValue to write a typed value, WriteCharEntity to write a character entity, WriteAttributeString to write an attribute, or you can write a child element. Jest to bardziej zaawansowana wersja WriteElementString metody.This is a more sophisticated version of the WriteElementString method.

Aby zamknąć element, należy wywołać WriteEndElement metodę lub. WriteFullEndElementTo close the element, you call the WriteEndElement or WriteFullEndElement method.
WriteNode Aby skopiować węzeł elementu znaleziony w bieżącym miejscu XmlReader obiektu lub. XPathNavigatorTo copy an element node found at the current position of an XmlReader or XPathNavigator object. Gdy jest wywoływana, kopiuje wszystko z obiektu źródłowego do XmlWriter wystąpienia.When called, it copies everything from the source object to the XmlWriter instance.

Pisanie atrybutówWriting attributes

Przy użyciu poniższych XmlWriter metod można pisać atrybuty w węzłach elementów.You can use the following XmlWriter methods to write attributes on element nodes. Te metody mogą również służyć do tworzenia deklaracji przestrzeni nazw dla elementu, zgodnie z opisem w następnej sekcji.These methods can also be used to create namespace declarations on an element, as discussed in the next section.

ZastosowanieUse ZadanieTo
WriteAttributeString Aby napisać cały węzeł atrybutu, w tym wartość ciągu.To write an entire attribute node, including a string value.
WriteStartAttribute Aby zapisać wartość atrybutu przy użyciu wielu wywołań metod.To write the attribute value using multiple method calls. Na przykład można wywołać WriteValue , aby napisać wartość wpisaną.For example, you can call WriteValue to write a typed value. Jest to bardziej zaawansowana wersja WriteElementString metody.This is a more sophisticated version of the WriteElementString method.

Aby zamknąć element, należy wywołać WriteEndAttribute metodę.To close the element, you call the WriteEndAttribute method.
WriteAttributes Aby skopiować wszystkie atrybuty znalezione na bieżącym miejscu XmlReader obiektu.To copy all the attributes found at the current position of an XmlReader object. Zapisywane atrybuty zależą od typu węzła, w którym jest obecnie umieszczony czytnik:The attributes that are written depend on the type of node the reader is currently positioned on:

— Dla węzła atrybutu zapisuje bieżący atrybut, a następnie resztę atrybutów do znacznika zamykającego elementu.- For an attribute node, it writes the current attribute, and then the rest of the attributes until the element closing tag.
-Dla węzła elementu zapisuje wszystkie atrybuty zawarte w elemencie.- For an element node, it writes all attributes contained by the element.
-Dla węzła deklaracji XML zapisuje wszystkie atrybuty w deklaracji.- For an XML declaration node, it writes all the attributes in the declaration.
— Dla wszystkich innych typów węzłów Metoda zgłasza wyjątek.- For all other node types, the method throws an exception.

Obsługa przestrzeni nazwHandling namespaces

Przestrzenie nazw służą do kwalifikowania nazw elementów i atrybutów w dokumencie XML.Namespaces are used to qualify element and attribute names in an XML document. Prefiksy przestrzeni nazw kojarzą elementy i atrybuty z przestrzeniami nazw, które są skojarzone z odwołaniami do identyfikatorów URI.Namespace prefixes associate elements and attributes with namespaces, which are in turn associated with URI references. Przestrzenie nazw tworzą unikatowość nazw elementów i atrybutów w dokumencie XML.Namespaces create element and attribute name uniqueness in an XML document.

XmlWriter Zachowuje stos przestrzeni nazw, który odnosi się do wszystkich przestrzeni nazw zdefiniowanych w bieżącym zakresie przestrzeni nazw.The XmlWriter maintains a namespace stack that corresponds to all the namespaces defined in the current namespace scope. Podczas pisania elementów i atrybutów można używać przestrzeni nazw w następujący sposób:When writing elements and attributes you can utilize namespaces in the following ways:

  • Ręcznie deklaruj przestrzenie nazw przy WriteAttributeString użyciu metody.Declare namespaces manually by using the WriteAttributeString method. Może to być przydatne, gdy wiesz, jak najlepiej zoptymalizować liczbę deklaracji przestrzeni nazw.This can be useful when you know how to best optimize the number of namespace declarations. Aby zapoznać się z przykładem WriteAttributeString(String, String, String, String) , zobacz metodę.For an example, see the WriteAttributeString(String, String, String, String) method.

  • Zastąp bieżącą deklarację przestrzeni nazw nową przestrzenią nazw.Override the current namespace declaration with a new namespace. W poniższym kodzie WriteAttributeString Metoda zmienia identyfikator URI przestrzeni nazw "x" dla prefiksu z "123" na "abc".In the following code, the WriteAttributeString method changes the namespace URI for the "x" prefix from "123" to "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:The code generates the following XML string:

    <x:root xmlns:x="123">  
      <item xmlns:x="abc" />  
    </x:root>  
    
  • Określ prefiks przestrzeni nazw podczas pisania atrybutów lub elementów.Specify a namespace prefix when writing attributes or elements. Wiele metod służących do zapisywania elementów i atrybutów umożliwia wykonywanie tych czynności.Many of the methods used to write element and attributes enable you to do this. Na przykład WriteStartElement(String, String, String) Metoda zapisuje tag początkowy i kojarzy go z określonym obszarem nazw i prefiksem.For example, the WriteStartElement(String, String, String) method writes a start tag and associates it with a specified namespace and prefix.

Zapisywanie danych wpisanychWriting typed data

Metoda akceptuje obiekt środowiska uruchomieniowego języka wspólnego (CLR), konwertuje wartość wejściową na jej reprezentację w postaci ciągu zgodnie z regułami konwersji typów danych języka definicji schematu XML (XSD) i zapisuje je za WriteString pomocą metody. WriteValueThe WriteValue method accepts a common language runtime (CLR) object, converts the input value to its string representation according to XML schema definition language (XSD) data type conversion rules, and writes it out by using the WriteString method. Jest to łatwiejsze niż użycie metod w XmlConvert klasie w celu przekonwertowania wpisanych danych na wartość ciągu przed ich zapisaniem.This is easier than using the methods in the XmlConvert class to convert the typed data to a string value before writing it out.

Podczas zapisywania do tekstu wartość wpisanej jest serializowana do tekstu przy użyciu XmlConvert reguł dla tego typu schematu.When writing to text, the typed value is serialized to text by using the XmlConvert rules for that schema type.

W przypadku domyślnych typów danych XSD, które odpowiadają typom CLR WriteValue , zobacz metodę.For default XSD data types that correspond to CLR types, see the WriteValue method.

XmlWriter Może również służyć do zapisu w magazynie danych XML.The XmlWriter can also be used to write to an XML data store. Na przykład XPathNavigator Klasa może XmlWriter utworzyć obiekt XmlDocument , aby utworzyć węzły dla obiektu.For example, the XPathNavigator class can create an XmlWriter object to create nodes for an XmlDocument object. Jeśli magazyn danych ma dostępne informacje o schemacie, WriteValue Metoda zgłasza wyjątek, jeśli próba konwersji na typ, który jest niedozwolony. Jeśli magazyn danych nie ma dostępnych informacji o schemacie, WriteValue Metoda traktuje wszystkie wartości xsd:anySimpleType jako typ.If the data store has schema information available to it, the WriteValue method throws an exception if you try to convert to a type that is not allowed.If the data store does not have schema information available to it, the WriteValue method treats all values as an xsd:anySimpleType type.

Zamykanie składnika zapisywania XMLClosing the XML writer

W przypadku używania XmlWriter metod do wyprowadzania kodu XML elementy i atrybuty nie są zapisywane do momentu Close wywołania metody.When you use XmlWriter methods to output XML, the elements and attributes are not written until you call the Close method. Na przykład, jeśli używasz XmlWriter do XmlDocument wypełniania obiektu, nie będzie można zobaczyć elementów i atrybutów pisanych w XmlWriter dokumencie docelowym do momentu zamknięcia wystąpienia.For example, if you are using XmlWriter to populate an XmlDocument object, you won't be able to see the written elements and attributes in the target document until you close the XmlWriter instance.

Programowanie asynchroniczneAsynchronous programming

XmlWriter Większość metod ma asynchroniczne odpowiedniki, które mają wartość "Async" na końcu nazw metod.Most of the XmlWriter methods have asynchronous counterparts that have "Async" at the end of their method names. Na przykład asynchroniczny odpowiednik WriteAttributeString to. WriteAttributeStringAsyncFor example, the asynchronous equivalent of WriteAttributeString is WriteAttributeStringAsync.

Dla metody, która nie ma odpowiednika asynchronicznego, przekonwertuj wartość zwracaną na ciąg i WriteStringAsync Użyj metody zamiast niej. WriteValueFor the WriteValue method, which doesn't have an asynchronous counterpart, convert the return value to a string and use the WriteStringAsync method instead.

Zagadnienia dotyczące bezpieczeństwaSecurity considerations

Podczas pracy z XmlWriter klasą należy wziąć pod uwagę następujące kwestie:Consider the following when working with the XmlWriter class:

  • Wyjątki zgłoszone przez XmlWriter program mogą ujawniać informacje o ścieżce, które nie mają być rzutowane do aplikacji.Exceptions thrown by the XmlWriter can disclose path information that you do not want bubbled up to the app. Aplikacja musi przechwytywać wyjątki i przetwarzać je odpowiednio.Your app must catch exceptions and process them appropriately.

  • XmlWriternie weryfikuje żadnych danych, które są przesyłane do WriteDocType metody lub. WriteRawXmlWriter does not validate any data that is passed to the WriteDocType or WriteRaw method. Nie należy przekazywać dowolnych danych do tych metod.You should not pass arbitrary data to these methods.

Konstruktory

XmlWriter()

Inicjuje nowe wystąpienie klasy XmlWriter klasy.Initializes a new instance of the XmlWriter class.

Właściwości

Settings

Pobiera obiekt użyty do utworzenia tego XmlWriter wystąpienia. XmlWriterSettingsGets the XmlWriterSettings object used to create this XmlWriter instance.

WriteState

Gdy jest zastępowany w klasie pochodnej, Pobiera stan składnika zapisywania.When overridden in a derived class, gets the state of the writer.

XmlLang

Gdy jest zastępowany w klasie pochodnej, pobiera bieżący xml:lang zakres.When overridden in a derived class, gets the current xml:lang scope.

XmlSpace

Gdy jest zastępowany w klasie pochodnej, pobiera XmlSpace reprezentuje bieżący xml:space zakres.When overridden in a derived class, gets an XmlSpace representing the current xml:space scope.

Metody

Close()

Gdy jest zastępowany w klasie pochodnej, zamyka ten strumień i źródłowy strumień.When overridden in a derived class, closes this stream and the underlying stream.

Create(Stream)

Tworzy nowe XmlWriter wystąpienie przy użyciu określonego strumienia.Creates a new XmlWriter instance using the specified stream.

Create(Stream, XmlWriterSettings)

Tworzy nowe XmlWriter wystąpienie przy użyciu strumienia i XmlWriterSettings obiektu.Creates a new XmlWriter instance using the stream and XmlWriterSettings object.

Create(String)

Tworzy nowe XmlWriter wystąpienie przy użyciu określonej nazwy pliku.Creates a new XmlWriter instance using the specified filename.

Create(String, XmlWriterSettings)

Tworzy nowe XmlWriter wystąpienie przy użyciu nazwy pliku i XmlWriterSettings obiektu.Creates a new XmlWriter instance using the filename and XmlWriterSettings object.

Create(StringBuilder)

Tworzy nowe XmlWriter wystąpienie przy użyciu określonego StringBuilderelementu.Creates a new XmlWriter instance using the specified StringBuilder.

Create(StringBuilder, XmlWriterSettings)

Tworzy nowe XmlWriter wystąpienie StringBuilder przy użyciu obiektów i XmlWriterSettings .Creates a new XmlWriter instance using the StringBuilder and XmlWriterSettings objects.

Create(TextWriter)

Tworzy nowe XmlWriter wystąpienie przy użyciu określonego TextWriterelementu.Creates a new XmlWriter instance using the specified TextWriter.

Create(TextWriter, XmlWriterSettings)

Tworzy nowe XmlWriter wystąpienie TextWriter przy użyciu obiektów i XmlWriterSettings .Creates a new XmlWriter instance using the TextWriter and XmlWriterSettings objects.

Create(XmlWriter)

Tworzy nowe XmlWriter wystąpienie przy użyciu określonego XmlWriter obiektu.Creates a new XmlWriter instance using the specified XmlWriter object.

Create(XmlWriter, XmlWriterSettings)

Tworzy nowe XmlWriter wystąpienie przy użyciu określonych XmlWriter obiektów i XmlWriterSettings .Creates a new XmlWriter instance using the specified XmlWriter and XmlWriterSettings objects.

Dispose()

Zwalnia wszystkie zasoby używane przez bieżące wystąpienie XmlWriter klasy.Releases all resources used by the current instance of the XmlWriter class.

Dispose(Boolean)

Zwalnia niezarządzane zasoby używane przez XmlWriter program i opcjonalnie zwalnia zarządzane zasoby.Releases the unmanaged resources used by the XmlWriter and optionally releases the managed resources.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
Flush()

Gdy jest zastępowany w klasie pochodnej, opróżnia w buforze do źródłowych strumieni, a także opróżnia strumień źródłowy.When overridden in a derived class, flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

FlushAsync()

Asynchronicznie opróżnia w buforze do źródłowych strumieni, a także opróżnia strumień źródłowy.Asynchronously flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
LookupPrefix(String)

Gdy jest zastępowany w klasie pochodnej, zwraca najbliższy prefiks zdefiniowany w zakresie bieżącego obszaru nazw dla identyfikatora URI przestrzeni nazw.When overridden in a derived class, returns the closest prefix defined in the current namespace scope for the namespace URI.

MemberwiseClone()

Tworzy skróconą kopię bieżącego Objectelementu.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
WriteAttributes(XmlReader, Boolean)

Gdy jest zastępowany w klasie pochodnej, program zapisuje wszystkie atrybuty znajdujące się w bieżącej pozycji w XmlReader.When overridden in a derived class, writes out all the attributes found at the current position in the XmlReader.

WriteAttributesAsync(XmlReader, Boolean)

Asynchronicznie zapisuje wszystkie atrybuty, które znajdują się w bieżącej pozycji XmlReaderw.Asynchronously writes out all the attributes found at the current position in the XmlReader.

WriteAttributeString(String, String)

Gdy jest zastępowany w klasie pochodnej, zapisuje atrybut z określoną nazwą lokalną i wartością.When overridden in a derived class, writes out the attribute with the specified local name and value.

WriteAttributeString(String, String, String)

Gdy jest zastępowany w klasie pochodnej, zapisuje atrybut z określoną nazwą lokalną, identyfikatorem URI przestrzeni nazw i wartością.When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.

WriteAttributeString(String, String, String, String)

Gdy jest zastępowany w klasie pochodnej, zapisuje atrybut z określonym prefiksem, nazwą lokalną, identyfikatorem URI przestrzeni nazw i wartością.When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteAttributeStringAsync(String, String, String, String)

Asynchronicznie zapisuje atrybut z określonym prefiksem, nazwą lokalną, identyfikatorem URI przestrzeni nazw i wartością.Asynchronously writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteBase64(Byte[], Int32, Int32)

Gdy jest zastępowany w klasie pochodnej, koduje określone bajty binarne jako base64 i zapisuje powstały tekst.When overridden in a derived class, encodes the specified binary bytes as Base64 and writes out the resulting text.

WriteBase64Async(Byte[], Int32, Int32)

Asynchronicznie koduje określone bajty binarne jako base64 i zapisuje otrzymany tekst.Asynchronously encodes the specified binary bytes as Base64 and writes out the resulting text.

WriteBinHex(Byte[], Int32, Int32)

Gdy jest zastępowany w klasie pochodnej, koduje określone bajty binarne BinHex jako i zapisuje powstały tekst.When overridden in a derived class, encodes the specified binary bytes as BinHex and writes out the resulting text.

WriteBinHexAsync(Byte[], Int32, Int32)

Asynchronicznie koduje określone bajty binarne BinHex jako i zapisuje otrzymany tekst.Asynchronously encodes the specified binary bytes as BinHex and writes out the resulting text.

WriteCData(String)

W przypadku przesłonięcia w klasie pochodnej, zapisuje <![CDATA [...]]> bloku zawierających określony tekst.When overridden in a derived class, writes out a <![CDATA[...]]> block containing the specified text.

WriteCDataAsync(String)

Zapisuje asynchronicznie <![CDATA [...]]> bloku zawierających określony tekst.Asynchronously writes out a <![CDATA[...]]> block containing the specified text.

WriteCharEntity(Char)

Gdy jest zastępowany w klasie pochodnej, wymusza generowanie jednostki znaku dla określonej wartości znaku Unicode.When overridden in a derived class, forces the generation of a character entity for the specified Unicode character value.

WriteCharEntityAsync(Char)

Asynchronicznie wymusza generowanie jednostki znaku dla określonej wartości znaku Unicode.Asynchronously forces the generation of a character entity for the specified Unicode character value.

WriteChars(Char[], Int32, Int32)

Gdy jest zastępowany w klasie pochodnej, zapisuje tekst jeden bufor w danym momencie.When overridden in a derived class, writes text one buffer at a time.

WriteCharsAsync(Char[], Int32, Int32)

Asynchronicznie zapisuje tekst po jednym buforze w danym momencie.Asynchronously writes text one buffer at a time.

WriteComment(String)

Gdy jest zastępowany w klasie pochodnej, zapisuje komentarz <!--...--> zawierający określony tekst.When overridden in a derived class, writes out a comment <!--...--> containing the specified text.

WriteCommentAsync(String)

Asynchronicznie zapisuje komentarz <!--...--> zawierający określony tekst.Asynchronously writes out a comment <!--...--> containing the specified text.

WriteDocType(String, String, String, String)

Gdy jest zastępowany w klasie pochodnej, zapisuje deklarację DOCTYPE z określoną nazwą i opcjonalnymi atrybutami.When overridden in a derived class, writes the DOCTYPE declaration with the specified name and optional attributes.

WriteDocTypeAsync(String, String, String, String)

Asynchronicznie zapisuje deklarację DOCTYPE z określoną nazwą i opcjonalnymi atrybutami.Asynchronously writes the DOCTYPE declaration with the specified name and optional attributes.

WriteElementString(String, String)

Zapisuje element z określoną nazwą lokalną i wartością.Writes an element with the specified local name and value.

WriteElementString(String, String, String)

Zapisuje element z określoną nazwą lokalną, identyfikatorem URI przestrzeni nazw i wartością.Writes an element with the specified local name, namespace URI, and value.

WriteElementString(String, String, String, String)

Zapisuje element z określonym prefiksem, nazwą lokalną, identyfikatorem URI przestrzeni nazw i wartością.Writes an element with the specified prefix, local name, namespace URI, and value.

WriteElementStringAsync(String, String, String, String)

Asynchronicznie zapisuje element z określonym prefiksem, nazwą lokalną, identyfikatorem URI przestrzeni nazw i wartością.Asynchronously writes an element with the specified prefix, local name, namespace URI, and value.

WriteEndAttribute()

Gdy jest zastępowany w klasie pochodnej, zamyka poprzednie WriteStartAttribute(String, String) wywołanie.When overridden in a derived class, closes the previous WriteStartAttribute(String, String) call.

WriteEndAttributeAsync()

Asynchronicznie zamyka poprzednie WriteStartAttribute(String, String) wywołanie.Asynchronously closes the previous WriteStartAttribute(String, String) call.

WriteEndDocument()

Gdy jest zastępowany w klasie pochodnej, zamyka wszystkie otwarte elementy lub atrybuty i umieszcza moduł zapisujący z powrotem w stanie początkowym.When overridden in a derived class, closes any open elements or attributes and puts the writer back in the Start state.

WriteEndDocumentAsync()

Asynchronicznie zamyka wszystkie otwarte elementy lub atrybuty i umieszcza moduł zapisujący z powrotem w stanie początkowym.Asynchronously closes any open elements or attributes and puts the writer back in the Start state.

WriteEndElement()

Gdy jest zastępowany w klasie pochodnej, zamyka jeden element i pop odpowiadający zakres przestrzeni nazw.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

WriteEndElementAsync()

Asynchronicznie zamyka jeden element i pop odpowiadający zakres przestrzeni nazw.Asynchronously closes one element and pops the corresponding namespace scope.

WriteEntityRef(String)

Gdy jest zastępowany w klasie pochodnej, zapisuje odwołanie do jednostki jako &name;.When overridden in a derived class, writes out an entity reference as &name;.

WriteEntityRefAsync(String)

Asynchronicznie zapisuje odwołanie do jednostki jako &name;.Asynchronously writes out an entity reference as &name;.

WriteFullEndElement()

Gdy jest zastępowany w klasie pochodnej, zamyka jeden element i pop odpowiadający zakres przestrzeni nazw.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

WriteFullEndElementAsync()

Asynchronicznie zamyka jeden element i pop odpowiadający zakres przestrzeni nazw.Asynchronously closes one element and pops the corresponding namespace scope.

WriteName(String)

Gdy jest zastępowany w klasie pochodnej, zapisuje określoną nazwę, upewniając się, że jest to prawidłowa nazwa zgodnie z zaleceniem XML 1,0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).When overridden in a derived class, writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNameAsync(String)

Asynchronicznie zapisuje określoną nazwę, upewniając się, że jest to prawidłowa nazwa zgodnie z zaleceniem W3C XML 1,0https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name)(.Asynchronously writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNmToken(String)

Gdy jest zastępowany w klasie pochodnej, zapisuje określoną nazwę, upewniając się, że jest to prawidłowy element NmToken zgodnie z zaleceniem XML 1,0https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name)(.When overridden in a derived class, writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (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 element NmToken zgodnie z zaleceniem W3C XMLhttps://www.w3.org/TR/1998/REC-xml-19980210#NT-Name)1,0 (.Asynchronously writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNode(XmlReader, Boolean)

Gdy jest zastępowany w klasie pochodnej, kopiuje wszystko z czytnika do składnika zapisywania i przenosi czytnik na początek następnego elementu równorzędnego.When overridden in a derived class, copies everything from the reader to the writer and moves the reader to the start of the next sibling.

WriteNode(XPathNavigator, Boolean)

Kopiuje wszystko z XPathNavigator obiektu do składnika zapisywania.Copies everything from the XPathNavigator object to the writer. Pozycja XPathNavigator pozostaje niezmieniona.The position of the XPathNavigator remains unchanged.

WriteNodeAsync(XmlReader, Boolean)

Asynchronicznie kopiuje wszystko z czytnika do składnika zapisywania i przenosi czytelnika na początek następnego elementu równorzędnego.Asynchronously copies everything from the reader to the writer and moves the reader to the start of the next sibling.

WriteNodeAsync(XPathNavigator, Boolean)

Asynchronicznie kopiuje wszystko z XPathNavigator obiektu do składnika zapisywania.Asynchronously copies everything from the XPathNavigator object to the writer. Pozycja XPathNavigator pozostaje niezmieniona.The position of the XPathNavigator remains unchanged.

WriteProcessingInstruction(String, String)

Gdy jest zastępowany w klasie pochodnej, zapisuje instrukcję przetwarzania z odstępem między nazwą i tekstem w następujący sposób: <? nazwa tekstowa?.>When overridden in a derived class, writes out a processing instruction with a space between the name and text as follows: <?name text?>.

WriteProcessingInstructionAsync(String, String)

Asynchronicznie zapisuje instrukcję przetwarzania z odstępem między nazwą i tekstem w następujący sposób: <? Nazwij tekst?.>Asynchronously writes out a processing instruction with a space between the name and text as follows: <?name text?>.

WriteQualifiedName(String, String)

Gdy jest zastępowany w klasie pochodnej, zapisuje nazwę kwalifikowaną przestrzeni nazw.When overridden in a derived class, writes out the namespace-qualified name. Ta metoda wyszukuje prefiks, który znajduje się w zakresie dla danego obszaru nazw.This method looks up the prefix that is in scope for the given namespace.

WriteQualifiedNameAsync(String, String)

Asynchronicznie zapisuje nazwę kwalifikowaną przestrzeni nazw.Asynchronously writes out the namespace-qualified name. Ta metoda wyszukuje prefiks, który znajduje się w zakresie dla danego obszaru nazw.This method looks up the prefix that is in scope for the given namespace.

WriteRaw(Char[], Int32, Int32)

Gdy jest zastępowany w klasie pochodnej, ręcznie zapisuje pierwotne znaczniki z buforu znaków.When overridden in a derived class, writes raw markup manually from a character buffer.

WriteRaw(String)

Gdy jest zastępowany w klasie pochodnej, ręcznie zapisuje pierwotne znaczniki z ciągu.When overridden in a derived class, writes raw markup manually from a string.

WriteRawAsync(Char[], Int32, Int32)

Asynchronicznie zapisuje nieprzetworzone znaczniki ręcznie z buforu znaków.Asynchronously writes raw markup manually from a character buffer.

WriteRawAsync(String)

Asynchronicznie zapisuje nieprzetworzone znaczniki ręcznie z ciągu.Asynchronously writes raw markup manually from a string.

WriteStartAttribute(String)

Zapisuje początek atrybutu z określoną nazwą lokalną.Writes the start of an attribute with the specified local name.

WriteStartAttribute(String, String)

Zapisuje początek atrybutu z określoną nazwą lokalną i identyfikatorem URI przestrzeni nazw.Writes the start of an attribute with the specified local name and namespace URI.

WriteStartAttribute(String, String, String)

Gdy jest zastępowany w klasie pochodnej, zapisuje początek atrybutu z określonym prefiksem, nazwą lokalną i identyfikatorem URI przestrzeni nazw.When overridden in a derived class, writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartAttributeAsync(String, String, String)

Asynchronicznie zapisuje początek atrybutu z określonym prefiksem, nazwą lokalną i identyfikatorem URI przestrzeni nazw.Asynchronously writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartDocument()

Gdy jest zastępowany w klasie pochodnej, program zapisuje deklarację XML w wersji "1,0".When overridden in a derived class, writes the XML declaration with the version "1.0".

WriteStartDocument(Boolean)

Gdy jest zastępowany w klasie pochodnej, program zapisuje deklarację XML z wersją "1,0" i atrybutem autonomicznym.When overridden in a derived class, writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartDocumentAsync()

Asynchronicznie zapisuje deklarację XML w wersji "1,0".Asynchronously writes the XML declaration with the version "1.0".

WriteStartDocumentAsync(Boolean)

Asynchronicznie zapisuje deklarację XML przy użyciu wersji "1,0" i atrybutu autonomicznego.Asynchronously writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartElement(String)

Gdy jest zastępowany w klasie pochodnej, zapisuje tag początkowy z określoną nazwą lokalną.When overridden in a derived class, writes out a start tag with the specified local name.

WriteStartElement(String, String)

Gdy jest zastępowany w klasie pochodnej, zapisuje określony tag początkowy i kojarzy ją z podaną przestrzenią nazw.When overridden in a derived class, writes the specified start tag and associates it with the given namespace.

WriteStartElement(String, String, String)

Gdy jest zastępowany w klasie pochodnej, zapisuje określony tag początkowy i kojarzy go z podaną przestrzenią nazw i prefiksem.When overridden in a derived class, writes the specified start tag and associates it with the given namespace and prefix.

WriteStartElementAsync(String, String, String)

Asynchronicznie zapisuje określony tag początkowy i kojarzy go z podaną przestrzenią nazw i prefiksem.Asynchronously writes the specified start tag and associates it with the given namespace and prefix.

WriteString(String)

Gdy jest zastępowany w klasie pochodnej, zapisuje daną zawartość tekstową.When overridden in a derived class, writes the given text content.

WriteStringAsync(String)

Asynchronicznie zapisuje daną zawartość tekstową.Asynchronously writes the given text content.

WriteSurrogateCharEntity(Char, Char)

Gdy jest zastępowany w klasie pochodnej, generuje i zapisuje jednostkę znaku dwuskładnikowego dla pary znaków zastępczych.When overridden in a derived class, generates and writes the surrogate character entity for the surrogate character pair.

WriteSurrogateCharEntityAsync(Char, Char)

Asynchronicznie generuje i zapisuje jednostkę znaku dwuskładnikowego dla pary znaków zastępczych.Asynchronously generates and writes the surrogate character entity for the surrogate character pair.

WriteValue(Boolean)

Boolean Zapisuje wartość.Writes a Boolean value.

WriteValue(DateTime)

DateTime Zapisuje wartość.Writes a DateTime value.

WriteValue(DateTimeOffset)

DateTimeOffset Zapisuje wartość.Writes a DateTimeOffset value.

WriteValue(Decimal)

Decimal Zapisuje wartość.Writes a Decimal value.

WriteValue(Double)

Double Zapisuje wartość.Writes a Double value.

WriteValue(Int32)

Int32 Zapisuje wartość.Writes a Int32 value.

WriteValue(Int64)

Int64 Zapisuje wartość.Writes a Int64 value.

WriteValue(Object)

Zapisuje wartość obiektu.Writes the object value.

WriteValue(Single)

Zapisuje liczbę zmiennoprzecinkową o pojedynczej precyzji.Writes a single-precision floating-point number.

WriteValue(String)

String Zapisuje wartość.Writes a String value.

WriteWhitespace(String)

Gdy jest zastępowany w klasie pochodnej, zapisuje dany biały znak.When overridden in a derived class, writes out the given white space.

WriteWhitespaceAsync(String)

Asynchronicznie zapisuje dane z danego odstępu.Asynchronously writes out the given white space.

Jawne implementacje interfejsu

IDisposable.Dispose()

Aby uzyskać opis tego elementu członkowskiego, Dispose()Zobacz.For a description of this member, see Dispose().

Dotyczy

Zobacz też