XmlWriter Klass

Definition

Namnområde:
System.Xml
Sammansättningar:
System.Xml.dll, System.Xml.ReaderWriter.dll
Sammansättningar:
netstandard.dll, System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.dll
Sammansättning:
netstandard.dll
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs

Representerar en skrivare som ger ett snabbt, icke-cachelagrat, framåtriktat sätt att generera strömmar eller filer som innehåller XML-data.

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
Arv
Object
XmlWriter
Härledda
Implementeringar
IDisposable IAsyncDisposable

Exempel

Följande exempelkod visar hur du använder det asynkrona API:et för att generera 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();
    }
}

Kommentarer

Mer information om det här API:et finns i Kompletterande API-kommentarer för XmlWriter.

Konstruktorer

Name Description
XmlWriter()

Initierar en ny instans av XmlWriter klassen.

Egenskaper

Name Description
Settings

Hämtar objektet XmlWriterSettings som används för att skapa den här XmlWriter instansen.
WriteState

När det åsidosättas i en härledd klass hämtar du författarens tillstånd.
XmlLang

När det åsidosätts i en härledd klass hämtar det aktuella xml:lang omfånget.
XmlSpace

När det åsidosätts i en härledd klass får du en XmlSpace som representerar det aktuella xml:space omfånget.

Metoder

Name Description
Close()

När den åsidosätts i en härledd klass stänger den här strömmen och den underliggande strömmen.
Create(Stream, XmlWriterSettings)

Skapar en ny XmlWriter instans med hjälp av strömmen och XmlWriterSettings objektet.
Create(Stream)

Skapar en ny XmlWriter instans med den angivna strömmen.
Create(String, XmlWriterSettings)

Skapar en ny XmlWriter instans med filnamnet och XmlWriterSettings objektet.
Create(String)

Skapar en ny XmlWriter instans med det angivna filnamnet.
Create(StringBuilder, XmlWriterSettings)

Skapar en ny XmlWriter instans med hjälp av objekten StringBuilder och XmlWriterSettings .
Create(StringBuilder)

Skapar en ny XmlWriter instans med den angivna StringBuilder.
Create(TextWriter, XmlWriterSettings)

Skapar en ny XmlWriter instans med hjälp av objekten TextWriter och XmlWriterSettings .
Create(TextWriter)

Skapar en ny XmlWriter instans med den angivna TextWriter.
Create(XmlWriter, XmlWriterSettings)

Skapar en ny XmlWriter instans med hjälp av angivna XmlWriter objekt och XmlWriterSettings objekt.
Create(XmlWriter)

Skapar en ny XmlWriter instans med det angivna XmlWriter objektet.
Dispose()

Släpper alla resurser som används av den aktuella instansen XmlWriter av klassen.
Dispose(Boolean)

Släpper de ohanterade resurser som används av XmlWriter och släpper eventuellt de hanterade resurserna.
DisposeAsync()

Utför programdefinierade uppgifter som är associerade med att frigöra, frigöra eller återställa ohanterade resurser asynkront.
DisposeAsyncCore()

Utför programdefinierade uppgifter som är associerade med att frigöra, frigöra eller återställa hanterade resurser asynkront.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
Flush()

När det åsidosätts i en härledd klass rensas det som finns i bufferten till de underliggande strömmarna och rensar även den underliggande strömmen.
FlushAsync()

Rensar asynkront det som finns i bufferten till de underliggande strömmarna och rensar även den underliggande strömmen.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
LookupPrefix(String)

När det åsidosätts i en härledd klass returnerar det närmaste prefixet som definierats i det aktuella namnområdesomfånget för namnområdes-URI:n.
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
WriteAttributes(XmlReader, Boolean)

När du åsidosättas i en härledd klass skriver du ut alla attribut som finns på den aktuella positionen i XmlReader.
WriteAttributesAsync(XmlReader, Boolean)

Asynkront skriver ut alla attribut som finns på den aktuella positionen i XmlReader.
WriteAttributeString(String, String, String, String)

När det åsidosättas i en härledd klass skriver du ut attributet med angivet prefix, lokalt namn, namnområdes-URI och värde.
WriteAttributeString(String, String, String)

När det åsidosättas i en härledd klass skriver du ett attribut med det angivna lokala namnet, namnområdets URI och värde.
WriteAttributeString(String, String)

När det åsidosättas i en härledd klass skriver du ut attributet med det angivna lokala namnet och värdet.
WriteAttributeStringAsync(String, String, String, String)

Skriver asynkront ut attributet med angivet prefix, lokalt namn, namnområdes-URI och värde.
WriteBase64(Byte[], Int32, Int32)

När de åsidosättas i en härledd klass kodas de angivna binära byteen som Base64 och skriver ut den resulterande texten.
WriteBase64Async(Byte[], Int32, Int32)

Kodar asynkront de angivna binära byte som Base64 och skriver ut den resulterande texten.
WriteBinHex(Byte[], Int32, Int32)

När de åsidosättas i en härledd klass kodar de angivna binära byteen som BinHex och skriver ut den resulterande texten.
WriteBinHexAsync(Byte[], Int32, Int32)

Kodar asynkront de angivna binära byteen som BinHex och skriver ut den resulterande texten.
WriteCData(String)

När du åsidosättas i en härledd klass skriver du ut en <![ CDATA[...]]> som innehåller den angivna texten.
WriteCDataAsync(String)

Skriver asynkront ut en <![ CDATA[...]]> som innehåller den angivna texten.
WriteCharEntity(Char)

När du åsidosättas i en härledd klass tvingar du fram genereringen av en teckenentitet för det angivna Unicode-teckenvärdet.
WriteCharEntityAsync(Char)

Asynkront tvingar fram genereringen av en teckenentitet för det angivna Unicode-teckenvärdet.
WriteChars(Char[], Int32, Int32)

När du åsidosätter i en härledd klass skriver du text en buffert i taget.
WriteCharsAsync(Char[], Int32, Int32)

Skriver asynkront text en buffert i taget.
WriteComment(String)

När du åsidosättas i en härledd klass skriver du ut en kommentar <--...--> som innehåller den angivna texten.
WriteCommentAsync(String)

Skriver asynkront ut en kommentar <--...--> som innehåller den angivna texten.
WriteDocType(String, String, String, String)

När den åsidosättas i en härledd klass skriver du DOCTYPE-deklarationen med angivet namn och valfria attribut.
WriteDocTypeAsync(String, String, String, String)

Skriver asynkront DOCTYPE-deklarationen med angivet namn och valfria attribut.
WriteElementString(String, String, String, String)

Skriver ett element med angivet prefix, lokalt namn, namnområdes-URI och värde.
WriteElementString(String, String, String)

Skriver ett element med angivet lokalt namn, namnområdes-URI och värde.
WriteElementString(String, String)

Skriver ett element med det angivna lokala namnet och värdet.
WriteElementStringAsync(String, String, String, String)

Skriver asynkront ett element med angivet prefix, lokalt namn, namnområdes-URI och värde.
WriteEndAttribute()

När det åsidosättas i en härledd klass stänger det föregående WriteStartAttribute(String, String) anropet.
WriteEndAttributeAsync()

Asynkront stänger föregående WriteStartAttribute(String, String) anrop.
WriteEndDocument()

När det åsidosättas i en härledd klass stänger du alla öppna element eller attribut och placerar skrivaren i starttillståndet igen.
WriteEndDocumentAsync()

Stänger asynkront alla öppna element eller attribut och placerar skrivaren i starttillståndet igen.
WriteEndElement()

När det åsidosätts i en härledd klass stänger ett element och visar motsvarande namnområdesomfång.
WriteEndElementAsync()

Stänger asynkront ett element och visar motsvarande namnområdesomfång.
WriteEntityRef(String)

När du åsidosättas i en härledd klass skriver du ut en entitetsreferens som &name;.
WriteEntityRefAsync(String)

Asynkront skriver ut en entitetsreferens som &name;.
WriteFullEndElement()

När det åsidosätts i en härledd klass stänger ett element och visar motsvarande namnområdesomfång.
WriteFullEndElementAsync()

Stänger asynkront ett element och visar motsvarande namnområdesomfång.
WriteName(String)

När du åsidosätter i en härledd klass skriver du ut det angivna namnet, vilket säkerställer att det är ett giltigt namn enligt W3C XML 1.0-rekommendationen (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNameAsync(String)

Asynkront skriver ut det angivna namnet, vilket säkerställer att det är ett giltigt namn enligt W3C XML 1.0-rekommendationen (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmToken(String)

När du åsidosätter i en härledd klass skriver du ut det angivna namnet, vilket säkerställer att det är en giltig NmToken enligt W3C XML 1.0-rekommendationen (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmTokenAsync(String)

Asynkront skriver ut det angivna namnet, vilket säkerställer att det är en giltig NmToken enligt W3C XML 1.0-rekommendationen (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNode(XmlReader, Boolean)

När det åsidosättas i en härledd klass kopieras allt från läsaren till författaren och flyttar läsaren till början av nästa syskon.
WriteNode(XPathNavigator, Boolean)

Kopierar allt från objektet XPathNavigator till skrivaren. Positionen för förblir XPathNavigator oförändrad.
WriteNodeAsync(XmlReader, Boolean)

Kopierar asynkront allt från läsaren till författaren och flyttar läsaren till början av nästa syskon.
WriteNodeAsync(XPathNavigator, Boolean)

Kopierar asynkront allt från objektet XPathNavigator till skrivaren. Positionen för förblir XPathNavigator oförändrad.
WriteProcessingInstruction(String, String)

När du åsidosättas i en härledd klass skriver du ut en bearbetningsinstruktion med ett blanksteg mellan namnet och texten på följande sätt: <?name text?>.
WriteProcessingInstructionAsync(String, String)

Skriver asynkront ut en bearbetningsinstruktion med ett blanksteg mellan namnet och texten enligt följande: <?name text?>.
WriteQualifiedName(String, String)

När du åsidosättas i en härledd klass skriver du ut det namnområdeskvalificerade namnet. Den här metoden letar upp prefixet som finns i omfånget för det angivna namnområdet.
WriteQualifiedNameAsync(String, String)

Skriver asynkront ut det namnområdeskvalificerade namnet. Den här metoden letar upp prefixet som finns i omfånget för det angivna namnområdet.
WriteRaw(Char[], Int32, Int32)

När du åsidosättas i en härledd klass skriver du råpålägg manuellt från en teckenbuffert.
WriteRaw(String)

När du åsidosättas i en härledd klass skriver du råpålägg manuellt från en sträng.
WriteRawAsync(Char[], Int32, Int32)

Skriver asynkront rå markup manuellt från en teckenbuffert.
WriteRawAsync(String)

Skriver asynkront rå markup manuellt från en sträng.
WriteStartAttribute(String, String, String)

När det åsidosättas i en härledd klass skriver du början av ett attribut med angivet prefix, lokalt namn och namnområdes-URI.
WriteStartAttribute(String, String)

Skriver början av ett attribut med det angivna lokala namnet och namnområdes-URI:n.
WriteStartAttribute(String)

Skriver början av ett attribut med det angivna lokala namnet.
WriteStartAttributeAsync(String, String, String)

Skriver asynkront början av ett attribut med angivet prefix, lokalt namn och namnområdes-URI.
WriteStartDocument()

När den åsidosättas i en härledd klass skriver du XML-deklarationen med versionen "1.0".
WriteStartDocument(Boolean)

När den åsidosättas i en härledd klass skriver du XML-deklarationen med versionen "1.0" och det fristående attributet.
WriteStartDocumentAsync()

Skriver asynkront XML-deklarationen med versionen "1.0".
WriteStartDocumentAsync(Boolean)

Skriver asynkront XML-deklarationen med versionen "1.0" och det fristående attributet.
WriteStartElement(String, String, String)

När den åsidosättas i en härledd klass skriver du den angivna starttaggen och associerar den med det angivna namnområdet och prefixet.
WriteStartElement(String, String)

När den åsidosättas i en härledd klass skriver du den angivna starttaggen och associerar den med det angivna namnområdet.
WriteStartElement(String)

När du åsidosättas i en härledd klass skriver du ut en starttagg med det angivna lokala namnet.
WriteStartElementAsync(String, String, String)

Skriver asynkront den angivna starttaggen och associerar den med det angivna namnområdet och prefixet.
WriteString(String)

När du åsidosättas i en härledd klass skriver du det angivna textinnehållet.
WriteStringAsync(String)

Skriver asynkront det angivna textinnehållet.
WriteSurrogateCharEntity(Char, Char)

När den åsidosättas i en härledd klass genererar och skriver du surrogatteckenentiteten för surrogatteckenparet.
WriteSurrogateCharEntityAsync(Char, Char)

Genererar och skriver asynkront surrogatteckenentiteten för surrogatteckenparet.
WriteValue(Boolean)

Skriver ett Boolean värde.
WriteValue(DateTime)

Skriver ett DateTime värde.
WriteValue(DateTimeOffset)

Skriver ett DateTimeOffset värde.
WriteValue(Decimal)

Skriver ett Decimal värde.
WriteValue(Double)

Skriver ett Double värde.
WriteValue(Int32)

Skriver ett Int32 värde.
WriteValue(Int64)

Skriver ett Int64 värde.
WriteValue(Object)

Skriver objektvärdet.
WriteValue(Single)

Skriver ett flyttal med enkel precision.
WriteValue(String)

Skriver ett String värde.
WriteWhitespace(String)

När du åsidosättas i en härledd klass skriver du ut det angivna blanksteget.
WriteWhitespaceAsync(String)

Skriver asynkront ut det angivna blanksteget.

Explicita gränssnittsimplementeringar

Name Description
IDisposable.Dispose()

En beskrivning av den här medlemmen finns i Dispose().

Tilläggsmetoder

Name Description
ConfigureAwait(IAsyncDisposable, Boolean)

Konfigurerar hur väntar på de uppgifter som returneras från en asynkron disponibel ska utföras.

Gäller för

Se även