XmlWriter Sınıf

Tanım

XML verileri içeren akışlar veya dosyalar oluşturmak için hızlı, önbelleğe alınmamış, yalnızca iletme yolu sağlayan bir yazıcıyı temsil eder.

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
Devralma
XmlWriter
Türetilmiş
Uygulamalar

Ö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. xmlwriteriçin ek API açıklamaları .

Oluşturucular

XmlWriter()

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

Özellikler

Settings

Bu XmlWriter örneğini oluşturmak için kullanılan XmlWriterSettings nesnesini 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ını alır.

XmlSpace

Türetilmiş bir sınıfta geçersiz kılındığında, geçerli xml:space kapsamını 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 bir XmlWriter örneği oluşturur.

Create(Stream, XmlWriterSettings)

Akışı ve XmlWriterSettings nesnesini kullanarak yeni bir XmlWriter örneği oluşturur.

Create(String)

Belirtilen dosya adını kullanarak yeni bir XmlWriter örneği oluşturur.

Create(String, XmlWriterSettings)

dosya adını ve XmlWriterSettings nesnesini kullanarak yeni bir XmlWriter örneği oluşturur.

Create(StringBuilder)

Belirtilen StringBuilderkullanarak yeni bir XmlWriter örneği oluşturur.

Create(StringBuilder, XmlWriterSettings)

StringBuilder ve XmlWriterSettings nesnelerini kullanarak yeni bir XmlWriter örneği oluşturur.

Create(TextWriter)

Belirtilen TextWriterkullanarak yeni bir XmlWriter örneği oluşturur.

Create(TextWriter, XmlWriterSettings)

TextWriter ve XmlWriterSettings nesnelerini kullanarak yeni bir XmlWriter örneği oluşturur.

Create(XmlWriter)

Belirtilen XmlWriter nesnesini kullanarak yeni bir XmlWriter örneği oluşturur.

Create(XmlWriter, XmlWriterSettings)

Belirtilen XmlWriter ve XmlWriterSettings nesnelerini kullanarak yeni bir XmlWriter örneği 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 isteğe bağlı olarak yönetilen kaynakları 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ı serbest bırakma, serbest bırakma veya sıfırlama ile ilişkili uygulama tanımlı görevleri zaman uyumsuz olarak 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, arabellekteki her şeyi temel alınan akışlara boşaltır ve ayrıca temel alınan akışı temizler.

FlushAsync()

Arabellekteki her şeyi zaman uyumsuz olarak temel alınan 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()

Geçerli örneğin Type 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 Objectbasit bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden bir dize döndürür.

(Devralındığı yer: Object)
WriteAttributes(XmlReader, Boolean)

Türetilmiş bir sınıfta geçersiz kılındığında, XmlReadergeçerli konumunda bulunan tüm öznitelikleri yazar.

WriteAttributesAsync(XmlReader, Boolean)

XmlReadergeçerli konumunda bulunan tüm öznitelikleri zaman uyumsuz olarak yazar.

WriteAttributeString(String, String)

Türetilmiş bir sınıfta geçersiz kılındığında, özniteliğini 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ğere sahip bir öznitelik yazar.

WriteAttributeString(String, String, String, String)

Türetilmiş bir sınıfta geçersiz kılındığında özniteliğini belirtilen ön ek, yerel ad, ad alanı URI'si ve değerle yazar.

WriteAttributeStringAsync(String, String, String, String)

Belirtilen ön ek, yerel ad, ad alanı URI'si ve değerle özniteliğini 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ı BinHex olarak kodlar ve sonuçta elde edilen metni yazar.

WriteBinHexAsync(Byte[], Int32, Int32)

Belirtilen ikili baytları zaman uyumsuz olarak BinHex olarak kodlar ve sonuçta elde edilen metni yazar.

WriteCData(String)

Türetilmiş bir sınıfta geçersiz kılındığında, bir <! [CDATA[...]] Belirtilen metni içeren> bloğu.

WriteCDataAsync(String)

Zaman uyumsuz olarak bir <yazar! [CDATA[...]] Belirtilen metni içeren> bloğu.

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)

Metni zaman uyumsuz olarak 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çıklama <!--...--> 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'sine ve değere sahip bir öğe yazar.

WriteElementStringAsync(String, String, String, String)

Belirtilen ön ek, yerel ad, ad alanı URI'si ve değere 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ısını kapatır.

WriteEndAttributeAsync()

Önceki WriteStartAttribute(String, String) çağrısını 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şlangıç 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()

Zaman uyumsuz olarak bir öğeyi kapatır ve ilgili ad alanı kapsamını açar.

WriteEntityRef(String)

Türetilmiş bir sınıfta geçersiz kılındığında, &name;olarak bir varlık başvurusu yazar.

WriteEntityRefAsync(String)

Varlık başvurularını zaman uyumsuz olarak &name;olarak 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()

Zaman uyumsuz olarak bir öğeyi 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)

XPathNavigator nesnesinden yazıcıya her şeyi kopyalar. XPathNavigator konumu değişmeden kalır.

WriteNodeAsync(XmlReader, Boolean)

Okuyucudaki her şeyi zaman uyumsuz olarak yazıcıya kopyalar ve okuyucuyu bir sonraki eşdüzeyin başlangıcına taşır.

WriteNodeAsync(XPathNavigator, Boolean)

XPathNavigator nesnesindeki 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şluk içeren bir işleme yönergesi yazar: <?name text?>.

WriteProcessingInstructionAsync(String, String)

Ad ve metin arasında boşluk bulunan bir işlem yönergesini zaman uyumsuz olarak şu şekilde 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 belirtilen 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 zaman uyumsuz olarak vekil karakter varlığını oluşturur ve yazar.

WriteValue(Boolean)

bir Boolean değeri yazar.

WriteValue(DateTime)

bir DateTime değeri yazar.

WriteValue(DateTimeOffset)

bir DateTimeOffset değeri yazar.

WriteValue(Decimal)

bir Decimal değeri yazar.

WriteValue(Double)

bir Double değeri yazar.

WriteValue(Int32)

bir Int32 değeri yazar.

WriteValue(Int64)

bir Int64 değeri yazar.

WriteValue(Object)

Nesne değerini yazar.

WriteValue(Single)

Tek duyarlıklı kayan noktalı sayı yazar.

WriteValue(String)

bir String değeri 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.

Belirtik Arabirim Kullanımları

IDisposable.Dispose()

Bu üyenin açıklaması için bkz. Dispose().

Uzantı Metotları

ConfigureAwait(IAsyncDisposable, Boolean)

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

Şunlara uygulanır

Ayrıca bkz.

  • XML Belgeleri ve Veri