XmlWriter Sınıf

Tanım

XML verileri içeren akışlar veya dosyalar oluşturmak için hızlı, önbelleğe alınmamış ve salt ileri bir yol sağlayan bir yazıcıyı temsil eder.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 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.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();  
    }  
}  

Açıklamalar

XmlWriterSınıfı, XML verilerini bir akışa, dosyaya, metin okuyucusuna veya dizeye yazar.The XmlWriter class writes XML data to a stream, file, text reader, or string. Xml 1,0 (üçüncü sürüm) ÖNERILERINDE W3C Genişletilebilir Biçimlendirme Dili (XML) 1,0 (dördüncü sürüm) ve ad alanlarını destekler.It supports the W3C Extensible Markup Language (XML) 1.0 (fourth edition) and Namespaces in XML 1.0 (third edition) recommendations.

Sınıfının üyeleri şunları sağlar XmlWriter :The members of the XmlWriter class enable you to:

  • Karakterlerin geçerli XML karakterleri olduğunu ve bu öğe ve öznitelik adlarının geçerli XML adı olduğunu doğrulayın.Verify that the characters are legal XML characters and that element and attribute names are valid XML names.

  • XML belgesinin doğru biçimlendirildiğinden emin olun.Verify that the XML document is well-formed.

  • İkili baytları Base64 veya BinHex olarak kodlayın ve elde edilen metni yazın.Encode binary bytes as Base64 or BinHex, and write out the resulting text.

  • Değer dönüştürmelerini el ile gerçekleştirmek zorunda kalmamak için, dizeler yerine ortak dil çalışma zamanı türlerini kullanarak değerleri geçirin.Pass values by using common language runtime types instead of strings, to avoid having to manually perform value conversions.

  • Birden çok belgeyi bir çıkış akışına yazın.Write multiple documents to one output stream.

  • Geçerli adlar, nitelikli adlar ve ad belirteçleri yazın.Write valid names, qualified names, and name tokens.

Bu bölümdeki konular:In this section:

XML yazıcı oluşturma Creating an XML writer
Çıkış biçimini belirtme Specifying the output format
Veri uyumluluğu Data conformance
Öğeleri yazma Writing elements
Öznitelikleri yazma Writing attributes
Ad alanlarını işleme Handling namespaces
Yazılan verileri yazma Writing typed data
XML yazıcısını kapatma Closing the XML writer
Zaman uyumsuz programlama Asynchronous programming
Güvenlik konularıSecurity considerations

XML yazıcı oluşturmaCreating an XML writer

Bir örnek oluşturmak için XmlWriter XmlWriter.Create yöntemini kullanın.To create an XmlWriter instance, use the XmlWriter.Create method. XML yazıcı üzerinde etkinleştirmek istediğiniz özellik kümesini belirtmek için bir XmlWriterSettings Create yöntemine geçirin.To specify the set of features you want to enable on the XML writer, pass an XmlWriterSettings to the Create method. Aksi takdirde, varsayılan ayarlar kullanılır.Otherwise, default settings are used. CreateAyrıntılar için başvuru sayfalarına bakın.See the Create reference pages for details.

Çıkış biçimini belirtmeSpecifying the output format

XmlWriterSettingsSınıfı, çıktının nasıl biçimlendirildiğini denetleyen çeşitli özellikler içerir XmlWriter :The XmlWriterSettings class includes several properties that control how XmlWriter output is formatted:

ÖzellikProperty AçıklamaDescription
Encoding Kullanılacak metin kodlamasını belirtir.Specifies the text encoding to use. Varsayılan değer: Encoding.UTF8.The default is Encoding.UTF8.
Indent Öğelerin girintiedilip edilmeyeceğini gösterir.Indicates whether to indent elements. Varsayılan değer false (girintileme yok).The default is false (no indentation).
IndentChars Girintileme sırasında kullanılacak karakter dizesini belirtir.Specifies the character string to use when indenting. Varsayılan değer iki boşluklardan oluşamaz.The default is two spaces.
NewLineChars Satır sonları için kullanılacak karakter dizesini belirtir.Specifies the character string to use for line breaks. Varsayılan değer \r\n (satır başı, satır besleme).The default is \r\n (carriage return, line feed).
NewLineHandling Yeni satır karakterlerinin nasıl işleneceğini belirtir.Specifies how to handle newline characters.
NewLineOnAttributes Özniteliklerin yeni bir satıra mi yazılacağını gösterir.Indicates whether to write attributes on a new line. IndenttrueBu özellik kullanılırken olarak ayarlanmalıdır.Indent should be set to true when using this property. Varsayılan değer: false.The default is false.
OmitXmlDeclaration Bir XML bildirimi yazıp yazmayacağını gösterir.Indicates whether to write an XML declaration. Varsayılan değer: false.The default is false.

IndentVe IndentChars Özellikleri, ne kadar önemli boşluk biçimlendirileceğini denetler.The Indent and IndentChars properties control how insignificant white space is formatted. Örneğin, öğe düğümlerini girintilemek için: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)

NewLineOnAttributesHer bir özniteliği bir ek girintileme düzeyi ile yeni bir satıra yazmak için öğesini kullanın: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)

Veri uyumluluğuData conformance

XML yazıcı, XmlWriterSettings veri uygunluğu denetlemek için sınıfından iki özellik kullanır:An XML writer uses two properties from the XmlWriterSettings class to check for data conformance:

  • CheckCharactersÖzelliği, XML yazarının karakterleri denetlemesini ve XmlException W3C tarafından tanımlanan bir karakter geçerli aralığın dışındaysa bir özel durum oluşturmasını söyler.The 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ÖZELLIĞI XML yazıcısını, yazılan AKıŞıN W3C tarafından tanımlanan iyi biçimlendirilmiş BIR XML 1,0 belgesi veya belge parçasının kurallarıyla uyumlu olduğunu denetlemek için yapılandırır.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. Üç uyumluluk düzeyi aşağıdaki tabloda açıklanmıştır.The three conformance levels are described in the following table. Varsayılan değer: Document.The default is Document. Ayrıntılar için bkz XmlWriterSettings.ConformanceLevel . özelliği ve System.Xml.ConformanceLevel sabit listesi.For details, see the XmlWriterSettings.ConformanceLevel property and the System.Xml.ConformanceLevel enumeration.

    LevelLevel DescriptionDescription
    Document XML çıktısı, iyi biçimlendirilmiş bir XML 1,0 belgesi için kurallara uyar ve herhangi bir uyumlu işlemci tarafından işlenebilir.The XML output conforms to the rules for a well-formed XML 1.0 document and can be processed by any conforming processor.
    Fragment XML çıktısı, iyi biçimlendirilmiş bir XML 1,0 belge parçasının kurallarına uyar.The XML output conforms to the rules for a well-formed XML 1.0 document fragment.
    Auto XML yazıcı, gelen verilere göre hangi türde bağlama denetimi uygulanacağını (belge veya parça) belirler.The XML writer determines which level of conformation checking to apply (document or fragment) based on the incoming data.

Öğeleri yazmaWriting elements

XmlWriterÖğe düğümlerini yazmak için aşağıdaki yöntemleri kullanabilirsiniz.You can use the following XmlWriter methods to write element nodes. Örnekler için, listelenen yöntemlere bakın.For examples, see the methods listed.

KullanınUse AmaçTo
WriteElementString Bir dize değeri de dahil olmak üzere tüm öğe düğümünü yazın.Write an entire element node, including a string value.
WriteStartElement Birden çok yöntem çağrısı kullanarak bir öğe değeri yazmak için.To write an element value by using multiple method calls. Örneğin, bir WriteValue WriteCharEntity karakter varlığı yazmak, bir WriteAttributeString öznitelik yazmak için veya bir alt öğe yazmak için, yazılan bir değer yazmak üzere ' yi çağırabilirsiniz.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. Bu, yönteminin daha karmaşık bir sürümüdür WriteElementString .This is a more sophisticated version of the WriteElementString method.

Öğesini kapatmak için, WriteEndElement veya WriteFullEndElement yöntemini çağırın.To close the element, you call the WriteEndElement or WriteFullEndElement method.
WriteNode Bir veya nesnesinin geçerli konumunda bulunan bir öğe düğümünü kopyalamak için XmlReader XPathNavigator .To copy an element node found at the current position of an XmlReader or XPathNavigator object. Çağrıldığında, her şeyi kaynak nesnesinden XmlWriter örneğe kopyalar.When called, it copies everything from the source object to the XmlWriter instance.

Öznitelikleri yazmaWriting attributes

XmlWriterÖğe düğümlerinde öznitelikleri yazmak için aşağıdaki yöntemleri kullanabilirsiniz.You can use the following XmlWriter methods to write attributes on element nodes. Bu yöntemler, sonraki bölümde açıklandığı gibi bir öğede ad alanı bildirimleri oluşturmak için de kullanılabilir.These methods can also be used to create namespace declarations on an element, as discussed in the next section.

KullanınUse AmaçTo
WriteAttributeString Bir dize değeri de dahil olmak üzere bir öznitelik düğümünün tamamını yazmak için.To write an entire attribute node, including a string value.
WriteStartAttribute Birden çok yöntem çağrısı kullanarak öznitelik değeri yazmak için.To write the attribute value using multiple method calls. Örneğin, WriteValue yazılı bir değer yazmak için öğesini çağırabilirsiniz.For example, you can call WriteValue to write a typed value. Bu, yönteminin daha karmaşık bir sürümüdür WriteElementString .This is a more sophisticated version of the WriteElementString method.

Öğesini kapatmak için WriteEndAttribute yöntemini çağırın.To close the element, you call the WriteEndAttribute method.
WriteAttributes Bir nesnenin geçerli konumunda bulunan tüm öznitelikleri kopyalamak için XmlReader .To copy all the attributes found at the current position of an XmlReader object. Yazılan öznitelikler, okuyucu şu anda konumlandırılmış olan düğüm türüne bağlıdır:The attributes that are written depend on the type of node the reader is currently positioned on:

-Bir öznitelik düğümü için, geçerli özniteliği ve sonra öğe kapatma etiketine kadar özniteliklerin geri kalanını yazar.- For an attribute node, it writes the current attribute, and then the rest of the attributes until the element closing tag.
-Öğe düğümü için, öğesi tarafından içerilen tüm öznitelikleri yazar.- For an element node, it writes all attributes contained by the element.
-Bir XML bildirim düğümü için, tüm öznitelikleri bildirime yazar.- For an XML declaration node, it writes all the attributes in the declaration.
-Diğer tüm düğüm türleri için yöntem bir özel durum oluşturur.- For all other node types, the method throws an exception.

Ad alanlarını işlemeHandling namespaces

Ad alanları, bir XML belgesinde öğe ve öznitelik adlarını nitelemek için kullanılır.Namespaces are used to qualify element and attribute names in an XML document. Ad alanı önekleri öğeleri ve öznitelikleri ad alanları ile ilişkilendirir, bu da URI başvurularıyla ilişkilendirilir.Namespace prefixes associate elements and attributes with namespaces, which are in turn associated with URI references. Ad alanları bir XML belgesinde öğe ve öznitelik adı benzersizliği oluşturur.Namespaces create element and attribute name uniqueness in an XML document.

, XmlWriter Geçerli ad alanı kapsamında tanımlanmış tüm ad alanlarına karşılık gelen bir ad alanı yığınını tutar.The XmlWriter maintains a namespace stack that corresponds to all the namespaces defined in the current namespace scope. Öğeleri ve öznitelikleri yazarken ad alanlarını aşağıdaki yollarla kullanabilirsiniz:When writing elements and attributes you can utilize namespaces in the following ways:

  • Yöntemini kullanarak ad alanlarını el ile bildirin WriteAttributeString .Declare namespaces manually by using the WriteAttributeString method. Bu, ad alanı bildirimlerinin sayısını en iyi hale getirmeyi bildiğiniz durumlarda yararlı olabilir.This can be useful when you know how to best optimize the number of namespace declarations. Bir örnek için, bkz WriteAttributeString(String, String, String, String) . yöntemi.For an example, see the WriteAttributeString(String, String, String, String) method.

  • Geçerli ad alanı bildirimini yeni bir ad alanıyla geçersiz kılın.Override the current namespace declaration with a new namespace. Aşağıdaki kodda, WriteAttributeString yöntemi öneki için ad alanı URI 'sini "x" "123" olarak değiştirir "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 aşağıdaki XML dizesini üretir:The code generates the following XML string:

    <x:root xmlns:x="123">  
      <item xmlns:x="abc" />  
    </x:root>  
    
  • Öznitelikler veya öğeler yazılırken bir ad alanı öneki belirtin.Specify a namespace prefix when writing attributes or elements. Öğesi ve öznitelikleri yazmak için kullanılan yöntemlerin birçoğu bunu sizin için etkinleştirir.Many of the methods used to write element and attributes enable you to do this. Örneğin, WriteStartElement(String, String, String) yöntemi bir başlangıç etiketi yazar ve belirtilen bir ad alanı ve önekiyle ilişkilendirir.For example, the WriteStartElement(String, String, String) method writes a start tag and associates it with a specified namespace and prefix.

Yazılan verileri yazmaWriting typed data

WriteValueYöntemi, ortak dil çalışma zamanı (CLR) nesnesini kabul eder, XML şeması tanım dili (xsd) veri türü dönüştürme kurallarına göre giriş değerini dize temsiline dönüştürür ve metodunu kullanarak dışarı yazar WriteString .The 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. Bu, XmlConvert yazdığınız verileri yazmadan önce bir dize değerine dönüştürmek için sınıfındaki yöntemleri kullanmaktan daha kolaydır.This is easier than using the methods in the XmlConvert class to convert the typed data to a string value before writing it out.

Metne yazarken, yazılan değer XmlConvert Bu şema türünün kuralları kullanılarak metne serileştirilir.When writing to text, the typed value is serialized to text by using the XmlConvert rules for that schema type.

CLR türlerine karşılık gelen varsayılan XSD veri türleri için bkz WriteValue . yöntemi.For default XSD data types that correspond to CLR types, see the WriteValue method.

XmlWriterBIR XML veri deposuna yazmak için de kullanılabilir.The XmlWriter can also be used to write to an XML data store. Örneğin, XPathNavigator sınıfı XmlWriter bir nesne için düğüm oluşturmak üzere bir nesnesi oluşturabilir XmlDocument .For example, the XPathNavigator class can create an XmlWriter object to create nodes for an XmlDocument object. Veri deposunda kullanılabilir şema bilgisi varsa, WriteValue izin verilmeyen bir türe dönüştürmeye çalışırsanız Yöntem bir özel durum oluşturur.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. Veri deposunda kullanılabilir şema bilgisi yoksa, WriteValue yöntemi tüm değerleri bir tür olarak değerlendirir xsd:anySimpleType .If the data store does not have schema information available to it, the WriteValue method treats all values as an xsd:anySimpleType type.

XML yazıcısını kapatmaClosing the XML writer

XmlWriterXML çıktısını almak için yöntemler kullandığınızda, yöntemi çağırana kadar öğeler ve öznitelikler yazılmaz Close .When you use XmlWriter methods to output XML, the elements and attributes are not written until you call the Close method. Örneğin, XmlWriter bir nesneyi doldurmak için kullanıyorsanız XmlDocument , örneği kapatıncaya kadar, hedef belgede yazılı öğeleri ve öznitelikleri göremezsiniz XmlWriter .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.

Zaman uyumsuz programlamaAsynchronous programming

Yöntemlerin çoğu, XmlWriter yöntem adlarının sonunda "Async" olan zaman uyumsuz karşılıklara sahiptir.Most of the XmlWriter methods have asynchronous counterparts that have "Async" at the end of their method names. Örneğin, öğesinin zaman uyumsuz eşdeğeri WriteAttributeString WriteAttributeStringAsync .For example, the asynchronous equivalent of WriteAttributeString is WriteAttributeStringAsync.

WriteValueZaman uyumsuz karşılığı olmayan yöntemi için, dönüş değerini bir dizeye dönüştürün ve WriteStringAsync bunun yerine yöntemi kullanın.For the WriteValue method, which doesn't have an asynchronous counterpart, convert the return value to a string and use the WriteStringAsync method instead.

Güvenlik konularıSecurity considerations

Sınıfıyla çalışırken aşağıdakileri göz önünde bulundurun XmlWriter :Consider the following when working with the XmlWriter class:

  • Tarafından oluşturulan özel durumlar, XmlWriter uygulamaya kabarcıklanmasını istemediğiniz yol bilgilerini açığa çıkarabilir.Exceptions thrown by the XmlWriter can disclose path information that you do not want bubbled up to the app. Uygulamanız özel durumları yakalamalı ve uygun şekilde işlemelidir.Your app must catch exceptions and process them appropriately.

  • XmlWriter , veya yöntemine geçirilen verileri doğrulamaz WriteDocType WriteRaw .XmlWriter does not validate any data that is passed to the WriteDocType or WriteRaw method. Bu yöntemlere rastgele veri geçirmemelisiniz.You should not pass arbitrary data to these methods.

Oluşturucular

XmlWriter()

XmlWriter sınıfının yeni bir örneğini başlatır.Initializes a new instance of the XmlWriter class.

Özellikler

Settings

XmlWriterSettingsBu örneği oluşturmak için kullanılan nesneyi alır XmlWriter .Gets the XmlWriterSettings object used to create this XmlWriter instance.

WriteState

Türetilmiş bir sınıfta geçersiz kılındığında, yazıcının durumunu alır.When overridden in a derived class, gets the state of the writer.

XmlLang

Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kapsamı alır xml:lang .When overridden in a derived class, gets the current xml:lang scope.

XmlSpace

Türetilmiş bir sınıfta geçersiz kılındığında, XmlSpace geçerli kapsamı temsil eden bir alır xml:space .When overridden in a derived class, gets an XmlSpace representing the current xml:space scope.

Yöntemler

Close()

Türetilmiş bir sınıfta geçersiz kılınırsa, bu akışı ve temel alınan akışı kapatır.When overridden in a derived class, closes this stream and the underlying stream.

Create(Stream)

XmlWriterBelirtilen akışı kullanarak yeni bir örnek oluşturur.Creates a new XmlWriter instance using the specified stream.

Create(Stream, XmlWriterSettings)

XmlWriterStream ve Object kullanarak yeni bir örnek oluşturur XmlWriterSettings .Creates a new XmlWriter instance using the stream and XmlWriterSettings object.

Create(String)

XmlWriterBelirtilen dosya adını kullanarak yeni bir örnek oluşturur.Creates a new XmlWriter instance using the specified filename.

Create(String, XmlWriterSettings)

XmlWriterDosya adını ve nesnesini kullanarak yeni bir örnek oluşturur XmlWriterSettings .Creates a new XmlWriter instance using the filename and XmlWriterSettings object.

Create(StringBuilder)

Belirtilen ' i XmlWriter kullanarak yeni bir örnek oluşturur StringBuilder .Creates a new XmlWriter instance using the specified StringBuilder.

Create(StringBuilder, XmlWriterSettings)

XmlWriterVe nesnelerini kullanarak yeni bir örnek StringBuilder oluşturur XmlWriterSettings .Creates a new XmlWriter instance using the StringBuilder and XmlWriterSettings objects.

Create(TextWriter)

Belirtilen ' i XmlWriter kullanarak yeni bir örnek oluşturur TextWriter .Creates a new XmlWriter instance using the specified TextWriter.

Create(TextWriter, XmlWriterSettings)

XmlWriterVe nesnelerini kullanarak yeni bir örnek TextWriter oluşturur XmlWriterSettings .Creates a new XmlWriter instance using the TextWriter and XmlWriterSettings objects.

Create(XmlWriter)

XmlWriterBelirtilen nesneyi kullanarak yeni bir örnek oluşturur XmlWriter .Creates a new XmlWriter instance using the specified XmlWriter object.

Create(XmlWriter, XmlWriterSettings)

XmlWriterBelirtilen ve nesnelerini kullanarak yeni bir örnek XmlWriter oluşturur XmlWriterSettings .Creates a new XmlWriter instance using the specified XmlWriter and XmlWriterSettings objects.

Dispose()

XmlWriter sınıfının geçerli örneği tarafından kullanılan tüm kaynakları serbest bırakır.Releases all resources used by the current instance of the XmlWriter class.

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.Releases the unmanaged resources used by the XmlWriter and optionally releases the managed resources.

DisposeAsync()

Yönetilmeyen kaynakları zaman uyumsuz olarak boşaltma, serbest bırakma veya sıfırlama ile ilişkili uygulama tanımlı görevleri gerçekleştirir.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously.

DisposeAsyncCore()

Yönetilen kaynakları zaman uyumsuz olarak boşaltma, serbest bırakma veya sıfırlama ile ilişkili uygulama tanımlı görevleri gerçekleştirir.Performs application-defined tasks associated with freeing, releasing, or resetting managed resources asynchronously.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

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

Türetilmiş bir sınıfta geçersiz kılınırsa, temel alınan akışlara yönelik arabellekte olduğunu ve ayrıca temel alınan akışı temizler.When overridden in a derived class, flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

FlushAsync()

Arabelleğe alınan akışlara yönelik arabellekte ne olduğunu zaman uyumsuz olarak temizler ve ayrıca temel alınan akışı temizler.Asynchronously flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

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

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
LookupPrefix(String)

Türetilmiş bir sınıfta geçersiz kılınırsa, ad alanı URI 'SI için geçerli ad alanı kapsamında tanımlanan en yakın ön eki döndürür.When overridden in a derived class, returns the closest prefix defined in the current namespace scope for the namespace URI.

MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

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

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

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

Türetilmiş bir sınıfta geçersiz kılınırsa, içindeki geçerli konumda bulunan tüm öznitelikleri yazar XmlReader .When overridden in a derived class, writes out all the attributes found at the current position in the XmlReader.

WriteAttributesAsync(XmlReader, Boolean)

İçindeki geçerli konumda bulunan tüm öznitelikleri zaman uyumsuz olarak yazar XmlReader .Asynchronously writes out all the attributes found at the current position in the XmlReader.

WriteAttributeString(String, String)

Türetilmiş bir sınıfta geçersiz kılınırsa, belirtilen yerel adı ve değeri olan özniteliği yazar.When overridden in a derived class, writes out the attribute with the specified local name and value.

WriteAttributeString(String, String, String)

Türetilmiş bir sınıfta geçersiz kılınırsa, belirtilen yerel ada, ad alanı URI 'sine ve değere sahip bir öznitelik yazar.When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.

WriteAttributeString(String, String, String, String)

Türetilmiş bir sınıfta geçersiz kılınırsa, belirtilen önek, yerel ad, ad alanı URI 'SI ve değer ile özniteliği yazar.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)

Belirtilen önek, yerel ad, ad alanı URI 'SI ve değer ile özniteliği zaman uyumsuz olarak yazar.Asynchronously writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteBase64(Byte[], Int32, Int32)

Türetilmiş bir sınıfta geçersiz kılınırsa, belirtilen ikili baytları Base64 olarak kodlar ve elde edilen metni yazar.When overridden in a derived class, encodes the specified binary bytes as Base64 and writes out the resulting text.

WriteBase64Async(Byte[], Int32, Int32)

Belirtilen ikili bayt sayısını zaman uyumsuz olarak kodlanır ve elde edilen metni yazar.Asynchronously encodes the specified binary bytes as Base64 and writes out the resulting text.

WriteBinHex(Byte[], Int32, Int32)

Türetilmiş bir sınıfta geçersiz kılınırsa, belirtilen ikili baytları olarak kodlar BinHex ve elde edilen metni yazar.When overridden in a derived class, encodes the specified binary bytes as BinHex and writes out the resulting text.

WriteBinHexAsync(Byte[], Int32, Int32)

Belirtilen ikili baytları zaman uyumsuz olarak kodlar BinHex ve sonuçta elde edilen metni yazar.Asynchronously encodes the specified binary bytes as BinHex and writes out the resulting text.

WriteCData(String)

Türetilmiş bir sınıfta geçersiz kılınırsa, şunu dışarı yazar < ! [ CDATA [...]] > Belirtilen metni içeren blok.When overridden in a derived class, writes out a <![CDATA[...]]> block containing the specified text.

WriteCDataAsync(String)

Zaman uyumsuz olarak bir < ! [yazar CDATA [...]] > Belirtilen metni içeren blok.Asynchronously writes out a <![CDATA[...]]> block containing the specified text.

WriteCharEntity(Char)

Türetilmiş bir sınıfta geçersiz kılınırsa, belirtilen Unicode karakter değeri için bir karakter varlığının üretilmesini zorlar.When overridden in a derived class, forces the generation of a character entity for the specified Unicode character value.

WriteCharEntityAsync(Char)

Belirtilen Unicode karakter değeri için bir karakter varlığının oluşturulmasını zaman uyumsuz olarak zorlar.Asynchronously forces the generation of a character entity for the specified Unicode character value.

WriteChars(Char[], Int32, Int32)

Türetilmiş bir sınıfta geçersiz kılınırsa, bir seferde bir arabelleğe metin yazar.When overridden in a derived class, writes text one buffer at a time.

WriteCharsAsync(Char[], Int32, Int32)

Zaman uyumsuz olarak metin bir arabelleğe yazar.Asynchronously writes text one buffer at a time.

WriteComment(String)

Türetilmiş bir sınıfta geçersiz kılınırsa, < belirtilen metni içeren!--...--bir yorum Yazar > .When overridden in a derived class, writes out a comment <!--...--> containing the specified text.

WriteCommentAsync(String)

Zaman uyumsuz olarak < belirtilen metni içeren bir açıklama yazar!--...-- > .Asynchronously writes out a comment <!--...--> containing the specified text.

WriteDocType(String, String, String, String)

Türetilmiş bir sınıfta geçersiz kılınırsa, DOCTYPE bildirimini belirtilen ad ve isteğe bağlı özniteliklerle yazar.When overridden in a derived class, writes the DOCTYPE declaration with the specified name and optional attributes.

WriteDocTypeAsync(String, String, String, String)

Belirtilen ad ve isteğe bağlı özniteliklerle DOCTYPE bildirimini zaman uyumsuz olarak yazar.Asynchronously writes the DOCTYPE declaration with the specified name and optional attributes.

WriteElementString(String, String)

Belirtilen yerel adı ve değeri içeren bir öğe yazar.Writes an element with the specified local name and value.

WriteElementString(String, String, String)

Belirtilen yerel adı, ad alanı URI 'SI ve değeri olan bir öğe yazar.Writes an element with the specified local name, namespace URI, and value.

WriteElementString(String, String, String, String)

Belirtilen önek, yerel ad, ad alanı URI 'SI ve değer içeren bir öğe yazar.Writes an element with the specified prefix, local name, namespace URI, and value.

WriteElementStringAsync(String, String, String, String)

Zaman uyumsuz olarak belirtilen önek, yerel ad, ad alanı URI 'SI ve değer içeren bir öğe yazar.Asynchronously writes an element with the specified prefix, local name, namespace URI, and value.

WriteEndAttribute()

Türetilmiş bir sınıfta geçersiz kılınırsa, önceki çağrıyı kapatır WriteStartAttribute(String, String) .When overridden in a derived class, closes the previous WriteStartAttribute(String, String) call.

WriteEndAttributeAsync()

Önceki çağrıyı zaman uyumsuz olarak kapatır WriteStartAttribute(String, String) .Asynchronously closes the previous WriteStartAttribute(String, String) call.

WriteEndDocument()

Türetilmiş bir sınıfta geçersiz kılındığında, açık olan tüm öğeleri veya öznitelikleri kapatır ve yazıcıyı başlangıç durumuna geri koyar.When overridden in a derived class, closes any open elements or attributes and puts the writer back in the Start state.

WriteEndDocumentAsync()

Herhangi bir açık öğe veya özniteliği zaman uyumsuz olarak kapatır ve yazıcıyı başlangıç durumuna geri koyar.Asynchronously closes any open elements or attributes and puts the writer back in the Start state.

WriteEndElement()

Türetilmiş bir sınıfta geçersiz kılınırsa, bir öğeyi kapatır ve karşılık gelen ad alanı kapsamını açılır.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

WriteEndElementAsync()

Zaman uyumsuz bir öğeyi kapatır ve karşılık gelen ad alanı kapsamını açılır.Asynchronously closes one element and pops the corresponding namespace scope.

WriteEntityRef(String)

Türetilmiş bir sınıfta geçersiz kılınırsa, bir varlık başvurusunu olarak yazar &name; .When overridden in a derived class, writes out an entity reference as &name;.

WriteEntityRefAsync(String)

Zaman uyumsuz olarak bir varlık başvurusunu olarak yazar &name; .Asynchronously writes out an entity reference as &name;.

WriteFullEndElement()

Türetilmiş bir sınıfta geçersiz kılınırsa, bir öğeyi kapatır ve karşılık gelen ad alanı kapsamını açılır.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

WriteFullEndElementAsync()

Zaman uyumsuz bir öğeyi kapatır ve karşılık gelen ad alanı kapsamını açılır.Asynchronously closes one element and pops the corresponding namespace scope.

WriteName(String)

Türetilmiş bir sınıfta geçersiz kılınırsa, belirtilen adı yazar, bu da W3C XML 1,0 önerisine göre geçerli bir ad olduğundan emin olur ( 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)

Zaman uyumsuz olarak belirtilen adı yazar, bu da W3C XML 1,0 önerisine göre geçerli bir ad olduğundan emin olur ( https://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)

Türetilmiş bir sınıfta geçersiz kılınırsa, belirtilen adı yazar ve W3C XML 1,0 önerisine göre geçerli bir NmToken olduğundan emin olur ( 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 NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNmTokenAsync(String)

Zaman uyumsuz olarak belirtilen adı yazar, bu da W3C XML 1,0 önerisine göre geçerli bir NmToken olduğundan emin olur ( https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name) .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)

Türetilmiş bir sınıfta geçersiz kılındığında, okuyuculardan her şeyi yazıcıya kopyalar ve okuyucuyu sonraki eşdüzey öğesinin başlangıcına taşımalıdır.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)

Nesneden her şeyi XPathNavigator yazıcıya kopyalar.Copies everything from the XPathNavigator object to the writer. Konumunun konumu XPathNavigator değişmeden kalır.The position of the XPathNavigator remains unchanged.

WriteNodeAsync(XmlReader, Boolean)

Zaman uyumsuz olarak okuyuculardan her şeyi yazıcıya kopyalar ve okuyucuyu sonraki eşdüzey öğesinin başlangıcına taşıdır.Asynchronously copies everything from the reader to the writer and moves the reader to the start of the next sibling.

WriteNodeAsync(XPathNavigator, Boolean)

Zaman uyumsuz XPathNavigator olarak nesneden her şeyi yazıcıya kopyalar.Asynchronously copies everything from the XPathNavigator object to the writer. Konumunun konumu XPathNavigator değişmeden kalır.The position of the XPathNavigator remains unchanged.

WriteProcessingInstruction(String, String)

Türetilmiş bir sınıfta geçersiz kılınırsa, ad ve metin arasında boşluk içeren bir işleme yönergesini şu şekilde Yazar: < ? ad metni? > .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)

Zaman uyumsuz olarak, ad ve metin arasında boşluk olan bir işleme yönergesini şu şekilde Yazar: < ? metin metni? > .Asynchronously writes out a processing instruction with a space between the name and text as follows: <?name text?>.

WriteQualifiedName(String, String)

Türetilmiş bir sınıfta geçersiz kılınırsa, ad alanı nitelikli adı yazar.When overridden in a derived class, writes out the namespace-qualified name. Bu yöntem, verilen ad alanı için kapsamda olan ön eki arar.This method looks up the prefix that is in scope for the given namespace.

WriteQualifiedNameAsync(String, String)

Zaman uyumsuz olarak ad alanı nitelikli adı yazar.Asynchronously writes out the namespace-qualified name. Bu yöntem, verilen ad alanı için kapsamda olan ön eki arar.This method looks up the prefix that is in scope for the given namespace.

WriteRaw(Char[], Int32, Int32)

Türetilmiş bir sınıfta geçersiz kılınırsa, bir karakter arabelleğinden ham biçimlendirmeyi el ile yazar.When overridden in a derived class, writes raw markup manually from a character buffer.

WriteRaw(String)

Türetilmiş bir sınıfta geçersiz kılınırsa, bir dizeden el ile ham biçimlendirme yazar.When overridden in a derived class, writes raw markup manually from a string.

WriteRawAsync(Char[], Int32, Int32)

Zaman uyumsuz olarak, ham biçimlendirmeyi bir karakter arabelleğinden el ile yazar.Asynchronously writes raw markup manually from a character buffer.

WriteRawAsync(String)

Ham biçimlendirmeyi zaman uyumsuz olarak bir dizeden el ile yazar.Asynchronously writes raw markup manually from a string.

WriteStartAttribute(String)

Belirtilen yerel ada sahip bir özniteliğin başlangıcını yazar.Writes the start of an attribute with the specified local name.

WriteStartAttribute(String, String)

Belirtilen yerel ad ve ad alanı URI 'sine sahip bir özniteliğin başlangıcını yazar.Writes the start of an attribute with the specified local name and namespace URI.

WriteStartAttribute(String, String, String)

Türetilmiş bir sınıfta geçersiz kılınırsa, belirtilen önek, yerel ad ve ad alanı URI 'sine sahip bir özniteliğin başlangıcını yazar.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)

Belirtilen önek, yerel ad ve ad alanı URI 'sine sahip bir özniteliğin başlangıcını zaman uyumsuz olarak yazar.Asynchronously writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartDocument()

Türetilmiş bir sınıfta geçersiz kılınırsa, XML bildirimini "1,0" sürümüyle yazar.When overridden in a derived class, writes the XML declaration with the version "1.0".

WriteStartDocument(Boolean)

Türetilmiş bir sınıfta geçersiz kılınırsa, XML bildirimini "1,0" sürümü ve tek başına özniteliğiyle yazar.When overridden in a derived class, writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartDocumentAsync()

XML bildirimini "1,0" sürümü ile zaman uyumsuz olarak yazar.Asynchronously writes the XML declaration with the version "1.0".

WriteStartDocumentAsync(Boolean)

XML bildirimini "1,0" sürümü ve tek başına özniteliğiyle zaman uyumsuz olarak yazar.Asynchronously writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartElement(String)

Türetilmiş bir sınıfta geçersiz kılınırsa, belirtilen yerel ada sahip bir başlangıç etiketi yazar.When overridden in a derived class, writes out a start tag with the specified local name.

WriteStartElement(String, String)

Türetilmiş bir sınıfta geçersiz kılınırsa, belirtilen başlangıç etiketini yazar ve verilen ad alanıyla ilişkilendirir.When overridden in a derived class, writes the specified start tag and associates it with the given namespace.

WriteStartElement(String, String, String)

Türetilmiş bir sınıfta geçersiz kılınırsa, belirtilen başlangıç etiketini yazar ve verilen ad alanıyla ve önekle ilişkilendirir.When overridden in a derived class, writes the specified start tag and associates it with the given namespace and prefix.

WriteStartElementAsync(String, String, String)

Belirtilen başlangıç etiketini zaman uyumsuz olarak yazar ve verilen ad alanıyla ve önekle ilişkilendirir.Asynchronously writes the specified start tag and associates it with the given namespace and prefix.

WriteString(String)

Türetilmiş bir sınıfta geçersiz kılınırsa, verilen metin içeriğini yazar.When overridden in a derived class, writes the given text content.

WriteStringAsync(String)

Verilen metin içeriğini zaman uyumsuz olarak yazar.Asynchronously writes the given text content.

WriteSurrogateCharEntity(Char, Char)

Türetilmiş bir sınıfta geçersiz kılınırsa, vekil karakter çiftinin yedek karakter varlığını oluşturur ve yazar.When overridden in a derived class, generates and writes the surrogate character entity for the surrogate character pair.

WriteSurrogateCharEntityAsync(Char, Char)

Zaman uyumsuz olarak, yedek karakter çiftinin yedek karakter varlığını oluşturur ve yazar.Asynchronously generates and writes the surrogate character entity for the surrogate character pair.

WriteValue(Boolean)

Bir Boolean değer yazar.Writes a Boolean value.

WriteValue(DateTime)

Bir DateTime değer yazar.Writes a DateTime value.

WriteValue(DateTimeOffset)

Bir DateTimeOffset değer yazar.Writes a DateTimeOffset value.

WriteValue(Decimal)

Bir Decimal değer yazar.Writes a Decimal value.

WriteValue(Double)

Bir Double değer yazar.Writes a Double value.

WriteValue(Int32)

Bir Int32 değer yazar.Writes a Int32 value.

WriteValue(Int64)

Bir Int64 değer yazar.Writes a Int64 value.

WriteValue(Object)

Nesne değerini yazar.Writes the object value.

WriteValue(Single)

Tek duyarlıklı kayan noktalı sayı yazar.Writes a single-precision floating-point number.

WriteValue(String)

Bir String değer yazar.Writes a String value.

WriteWhitespace(String)

Türetilmiş bir sınıfta geçersiz kılınırsa, verilen boşluğu yazar.When overridden in a derived class, writes out the given white space.

WriteWhitespaceAsync(String)

Zaman uyumsuz olarak verilen boşluğu yazar.Asynchronously writes out the given white space.

Belirtik Arabirim Kullanımları

IDisposable.Dispose()

Bu üyenin açıklaması için bkz Dispose() ..For a description of this member, see Dispose().

Uzantı Metotları

ConfigureAwait(IAsyncDisposable, Boolean)

Zaman uyumsuz bir atılabilir döndürülen görevlerin ne kadar beklediğini yapılandırır.Configures how awaits on the tasks returned from an async disposable are performed.

Şunlara uygulanır