XmlWriter Sınıf

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Source:

XmlWriter.cs

XML verileri içeren akışlar veya dosyalar oluşturmanın hızlı, önbelleğe alınmamış, yalnızca ileri doğru bir yolunu sağlayan yazıcıyı temsil eder.

public ref class XmlWriter abstract : IAsyncDisposable, IDisposable

public abstract class XmlWriter : IAsyncDisposable, IDisposable

type XmlWriter = class
    interface IAsyncDisposable
    interface IDisposable

Public MustInherit Class XmlWriter
Implements IAsyncDisposable, IDisposable

Devralma

Object

XmlWriter

Türetilmiş

System.Xml.XmlDictionaryWriter

System.Xml.XmlTextWriter

System.Xml.Xsl.Runtime.XmlQueryOutput

Uygulamalar

IDisposable IAsyncDisposable

Örnekler

Aşağıdaki örnek kod, XML oluşturmak için zaman uyumsuz API'nin nasıl kullanılacağını gösterir.

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();
    }
}

Açıklamalar

Bu API hakkında daha fazla bilgi için bkz . XmlWriter için ek API açıklamaları.

Oluşturucular

XmlWriter()

XmlWriter sınıfının yeni bir örneğini başlatır.

Özellikler

Settings	XmlWriterSettings Bu XmlWriter örneği oluşturmak için kullanılan nesneyi alır.
WriteState	Türetilmiş bir sınıfta geçersiz kılındığında, yazıcının durumunu alır.
XmlLang	Türetilmiş bir sınıfta geçersiz kılındığında geçerli xml:lang kapsamı alır.
XmlSpace	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli xml:space kapsamı temsil eden bir XmlSpace alır.

Yöntemler

Close()	Türetilmiş bir sınıfta geçersiz kılındığında, bu akışı ve temel alınan akışı kapatır.
Create(Stream)	Belirtilen akışı kullanarak yeni XmlWriter bir örnek oluşturur.
Create(Stream, XmlWriterSettings)	Akışı ve XmlWriterSettings nesneyi kullanarak yeni XmlWriter bir örnek oluşturur.
Create(String)	Belirtilen dosya adını kullanarak yeni XmlWriter bir örnek oluşturur.
Create(String, XmlWriterSettings)	dosya adını ve XmlWriterSettings nesnesini kullanarak yeni XmlWriter bir örnek oluşturur.
Create(StringBuilder)	Belirtilen StringBuilderöğesini kullanarak yeni XmlWriter bir örnek oluşturur.
Create(StringBuilder, XmlWriterSettings)	ve XmlWriterSettings nesnelerini kullanarak StringBuilder yeni XmlWriter bir örnek oluşturur.
Create(TextWriter)	Belirtilen TextWriteröğesini kullanarak yeni XmlWriter bir örnek oluşturur.
Create(TextWriter, XmlWriterSettings)	ve XmlWriterSettings nesnelerini kullanarak TextWriter yeni XmlWriter bir örnek oluşturur.
Create(XmlWriter)	Belirtilen XmlWriter nesneyi kullanarak yeni XmlWriter bir örnek oluşturur.
Create(XmlWriter, XmlWriterSettings)	Belirtilen XmlWriter ve XmlWriterSettings nesnelerini kullanarak yeni XmlWriter bir örnek oluşturur.
Dispose()	XmlWriter sınıfının geçerli örneği tarafından kullanılan tüm kaynakları serbest bırakır.
Dispose(Boolean)	XmlWriter tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.
DisposeAsync()	Yönetilmeyen kaynakları zaman uyumsuz olarak serbest bırakma, serbest bırakma veya sıfırlama ile ilişkili uygulama tanımlı görevleri gerçekleştirir.
DisposeAsyncCore()	Yönetilen kaynakları zaman uyumsuz olarak serbest bırakma, serbest bırakma veya sıfırlama ile ilişkili uygulama tanımlı görevleri gerçekleştirir.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Flush()	Türetilmiş bir sınıfta geçersiz kılındığında, temel alınan akışların arabelleğindeki her şeyi temizler ve ayrıca temel alınan akışı temizler.
FlushAsync()	Arabelleğe alınan her şeyi zaman uyumsuz olarak temel akışlara boşaltır ve ayrıca temel alınan akışı temizler.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
LookupPrefix(String)	Türetilmiş bir sınıfta geçersiz kılındığında, ad alanı URI'sinin geçerli ad alanı kapsamında tanımlanan en yakın ön eki döndürür.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
WriteAttributes(XmlReader, Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında, içindeki geçerli konumda XmlReaderbulunan tüm öznitelikleri yazar.
WriteAttributesAsync(XmlReader, Boolean)	içinde geçerli konumda XmlReaderbulunan tüm öznitelikleri zaman uyumsuz olarak yazar.
WriteAttributeString(String, String)	Türetilmiş bir sınıfta geçersiz kılındığında, özniteliği belirtilen yerel ad ve değerle yazar.
WriteAttributeString(String, String, String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen yerel ada, ad alanı URI'sine ve değerine sahip bir öznitelik yazar.
WriteAttributeString(String, String, String, String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen ön ek, yerel ad, ad alanı URI'si ve değeriyle özniteliğini yazar.
WriteAttributeStringAsync(String, String, String, String)	Belirtilen ön ek, yerel ad, ad alanı URI'si ve değeriyle özniteliği zaman uyumsuz olarak yazar.
WriteBase64(Byte[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen ikili baytları Base64 olarak kodlar ve sonuçta elde edilen metni yazar.
WriteBase64Async(Byte[], Int32, Int32)	Belirtilen ikili baytları zaman uyumsuz olarak Base64 olarak kodlar ve sonuçta elde edilen metni yazar.
WriteBinHex(Byte[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen ikili baytları olarak BinHex kodlar ve sonuçta elde edilen metni yazar.
WriteBinHexAsync(Byte[], Int32, Int32)	Belirtilen ikili baytları zaman uyumsuz olarak BinHex kodlar ve sonuçta elde edilen metni yazar.
WriteCData(String)	Türetilmiş bir sınıfta geçersiz kılındığında bir ![ yazar < CDATA[...]]> belirtilen metni içeren blok.
WriteCDataAsync(String)	Zaman uyumsuz olarak bir <![ yazar CDATA[...]]> belirtilen metni içeren blok.
WriteCharEntity(Char)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen Unicode karakter değeri için karakter varlığının oluşturulmasını zorlar.
WriteCharEntityAsync(Char)	Belirtilen Unicode karakter değeri için bir karakter varlığının oluşturulmasını zaman uyumsuz olarak zorlar.
WriteChars(Char[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, metni bir kerede bir arabellek yazar.
WriteCharsAsync(Char[], Int32, Int32)	Zaman uyumsuz olarak metni bir kerede bir arabelleğe yazar.
WriteComment(String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen metni içeren bir açıklama <--...--> yazar.
WriteCommentAsync(String)	Belirtilen metni içeren bir açıklamayı <--...--> zaman uyumsuz olarak yazar.
WriteDocType(String, String, String, String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen ad ve isteğe bağlı özniteliklerle DOCTYPE bildirimini yazar.
WriteDocTypeAsync(String, String, String, String)	DOCTYPE bildirimini zaman uyumsuz olarak belirtilen ad ve isteğe bağlı özniteliklerle yazar.
WriteElementString(String, String)	Belirtilen yerel ada ve değere sahip bir öğe yazar.
WriteElementString(String, String, String)	Belirtilen yerel ada, ad alanı URI'sine ve değere sahip bir öğe yazar.
WriteElementString(String, String, String, String)	Belirtilen ön ek, yerel ad, ad alanı URI'si ve değere sahip bir öğe yazar.
WriteElementStringAsync(String, String, String, String)	Belirtilen ön ek, yerel ad, ad alanı URI'si ve değerine sahip bir öğeyi zaman uyumsuz olarak yazar.
WriteEndAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, önceki WriteStartAttribute(String, String) çağrıyı kapatır.
WriteEndAttributeAsync()	Önceki WriteStartAttribute(String, String) çağrıyı zaman uyumsuz olarak kapatır.
WriteEndDocument()	Türetilmiş bir sınıfta geçersiz kılındığında, açık öğeleri veya öznitelikleri kapatır ve yazıcıyı Yeniden Başlat durumuna getirir.
WriteEndDocumentAsync()	Açık öğeleri veya öznitelikleri zaman uyumsuz olarak kapatır ve yazıcıyı Yeniden Başlat durumuna getirir.
WriteEndElement()	Türetilmiş bir sınıfta geçersiz kılındığında, bir öğeyi kapatır ve ilgili ad alanı kapsamını açar.
WriteEndElementAsync()	Bir öğeyi zaman uyumsuz olarak kapatır ve ilgili ad alanı kapsamını açar.
WriteEntityRef(String)	Türetilmiş bir sınıfta geçersiz kılındığında, varlık başvurularını olarak &name;yazar.
WriteEntityRefAsync(String)	Varlık başvurularını zaman uyumsuz olarak olarak &name;yazar.
WriteFullEndElement()	Türetilmiş bir sınıfta geçersiz kılındığında, bir öğeyi kapatır ve ilgili ad alanı kapsamını açar.
WriteFullEndElementAsync()	Bir öğeyi zaman uyumsuz olarak kapatır ve ilgili ad alanı kapsamını açar.
WriteName(String)	Türetilmiş bir sınıfta geçersiz kılındığında, W3C XML 1.0 önerisine (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name ) göre geçerli bir ad olduğundan emin olarak belirtilen adı yazar.
WriteNameAsync(String)	W3C XML 1.0 önerisine (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name ) göre geçerli bir ad olduğundan emin olarak, belirtilen adı zaman uyumsuz olarak yazar.
WriteNmToken(String)	Türetilmiş bir sınıfta geçersiz kılındığında, W3C XML 1.0 önerisine (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name ) göre geçerli bir NmToken olduğundan emin olarak belirtilen adı yazar.
WriteNmTokenAsync(String)	W3C XML 1.0 önerisine (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name ) göre geçerli bir NmToken olduğundan emin olarak, belirtilen adı zaman uyumsuz olarak yazar.
WriteNode(XmlReader, Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında, okuyucudan yazıcıya her şeyi kopyalar ve okuyucuyu bir sonraki eşdüzeyin başına taşır.
WriteNode(XPathNavigator, Boolean)	Nesneden yazıcıya XPathNavigator her şeyi kopyalar. XPathNavigator Konumu değişmeden kalır.
WriteNodeAsync(XmlReader, Boolean)	Zaman uyumsuz olarak okuyucudan yazıcıya her şeyi kopyalar ve okuyucuyu bir sonraki eşdüzeyin başlangıcına taşır.
WriteNodeAsync(XPathNavigator, Boolean)	Nesnedeki XPathNavigator her şeyi zaman uyumsuz olarak yazıcıya kopyalar. XPathNavigator Konumu değişmeden kalır.
WriteProcessingInstruction(String, String)	Türetilmiş bir sınıfta geçersiz kılındığında, ad ve metin arasında aşağıdaki gibi bir boşlukla bir işleme yönergesi yazar: <?name text?>.
WriteProcessingInstructionAsync(String, String)	Ad ve metin arasında aşağıdaki gibi bir boşluk olan bir işleme yönergesini zaman uyumsuz olarak yazar: <?name text?>.
WriteQualifiedName(String, String)	Türetilmiş bir sınıfta geçersiz kılındığında ad alanı nitelenmiş adını yazar. Bu yöntem, verilen ad alanının kapsamındaki ön eki arar.
WriteQualifiedNameAsync(String, String)	Ad alanı nitelenmiş adını zaman uyumsuz olarak yazar. Bu yöntem, verilen ad alanının kapsamındaki ön eki arar.
WriteRaw(Char[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, bir karakter arabelleğinden el ile ham işaretleme yazar.
WriteRaw(String)	Türetilmiş bir sınıfta geçersiz kılındığında, bir dizeden el ile ham işaretleme yazar.
WriteRawAsync(Char[], Int32, Int32)	Ham işaretlemeyi bir karakter arabelleğinden el ile zaman uyumsuz olarak yazar.
WriteRawAsync(String)	Ham işaretlemeyi bir dizeden el ile zaman uyumsuz olarak yazar.
WriteStartAttribute(String)	Belirtilen yerel ada sahip bir özniteliğin başlangıcını yazar.
WriteStartAttribute(String, String)	Belirtilen yerel ad ve ad alanı URI'sine sahip bir özniteliğin başlangıcını yazar.
WriteStartAttribute(String, String, String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen ön ek, yerel ad ve ad alanı URI'sine sahip bir özniteliğin başlangıcını yazar.
WriteStartAttributeAsync(String, String, String)	Belirtilen ön ek, yerel ad ve ad alanı URI'sine sahip bir özniteliğin başlangıcını zaman uyumsuz olarak yazar.
WriteStartDocument()	Türetilmiş bir sınıfta geçersiz kılındığında, XML bildirimini "1.0" sürümüyle yazar.
WriteStartDocument(Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında, XML bildirimini "1.0" sürümü ve tek başına özniteliğiyle yazar.
WriteStartDocumentAsync()	XML bildirimini zaman uyumsuz olarak "1.0" sürümüyle yazar.
WriteStartDocumentAsync(Boolean)	XML bildirimini zaman uyumsuz olarak "1.0" sürümü ve tek başına özniteliğiyle yazar.
WriteStartElement(String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen yerel ada sahip bir başlangıç etiketi yazar.
WriteStartElement(String, String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen başlangıç etiketini yazar ve verilen ad alanıyla ilişkilendirir.
WriteStartElement(String, String, String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen başlangıç etiketini yazar ve belirtilen ad alanı ve ön ek ile ilişkilendirir.
WriteStartElementAsync(String, String, String)	Belirtilen başlangıç etiketini zaman uyumsuz olarak yazar ve belirtilen ad alanı ve ön ek ile ilişkilendirir.
WriteString(String)	Türetilmiş bir sınıfta geçersiz kılındığında, verilen metin içeriğini yazar.
WriteStringAsync(String)	Verilen metin içeriğini zaman uyumsuz olarak yazar.
WriteSurrogateCharEntity(Char, Char)	Türetilmiş bir sınıfta geçersiz kılındığında, vekil karakter çifti için vekil karakter varlığını oluşturur ve yazar.
WriteSurrogateCharEntityAsync(Char, Char)	Vekil karakter çifti için vekil karakter varlığını zaman uyumsuz olarak oluşturur ve yazar.
WriteValue(Boolean)	Bir Boolean değer yazar.
WriteValue(DateTime)	Bir DateTime değer yazar.
WriteValue(DateTimeOffset)	Bir DateTimeOffset değer yazar.
WriteValue(Decimal)	Bir Decimal değer yazar.
WriteValue(Double)	Bir Double değer yazar.
WriteValue(Int32)	Bir Int32 değer yazar.
WriteValue(Int64)	Bir Int64 değer yazar.
WriteValue(Object)	Nesne değerini yazar.
WriteValue(Single)	Tek duyarlıklı kayan noktalı bir sayı yazar.
WriteValue(String)	Bir String değer yazar.
WriteWhitespace(String)	Türetilmiş bir sınıfta geçersiz kılındığında, verilen boşluğu yazar.
WriteWhitespaceAsync(String)	Verilen boşluğu zaman uyumsuz olarak yazar.

Uzantı Metotları

ConfigureAwait(IAsyncDisposable, Boolean)

Zaman uyumsuz bir atılabilir öğeden döndürülen görevlerde awaits işleminin nasıl gerçekleştirildiğini yapılandırılır.

Ayrıca bkz.

• XML Belgeleri ve Verileri