XmlReader Sınıf

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlReader.cs

XML verilerine hızlı, boş, yalnızca ileriye doğru erişim sağlayan bir okuyucudur.

public ref class XmlReader abstract : IDisposable

public abstract class XmlReader : IDisposable

type XmlReader = class
    interface IDisposable

Public MustInherit Class XmlReader
Implements IDisposable

Devralma

Object

XmlReader

Türetilmiş

System.Xml.XmlDictionaryReader

System.Xml.XmlNodeReader

System.Xml.XmlTextReader

System.Xml.XmlValidatingReader

Uygulamalar

IDisposable

Örnekler

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

async Task TestReader(System.IO.Stream stream)
{
    XmlReaderSettings settings = new XmlReaderSettings();
    settings.Async = true;

    using (XmlReader reader = XmlReader.Create(stream, settings))
    {
        while (await reader.ReadAsync())
        {
            switch (reader.NodeType)
            {
                case XmlNodeType.Element:
                    Console.WriteLine("Start Element {0}", reader.Name);
                    break;
                case XmlNodeType.Text:
                    Console.WriteLine("Text Node: {0}",
                             await reader.GetValueAsync());
                    break;
                case XmlNodeType.EndElement:
                    Console.WriteLine("End Element {0}", reader.Name);
                    break;
                default:
                    Console.WriteLine("Other node {0} with value {1}",
                                    reader.NodeType, reader.Value);
                    break;
            }
        }
    }
}

Public Async Function TestReader(stream As System.IO.Stream) As Task
    Dim settings As New XmlReaderSettings()
    settings.Async = True

    Using reader As XmlReader = XmlReader.Create(stream, settings)
        While (Await reader.ReadAsync())
            Select Case (reader.NodeType)
                Case XmlNodeType.Element
                    Console.WriteLine("Start Element {0}", reader.Name)
                Case XmlNodeType.Text
                    Console.WriteLine("Text Node: {0}",
                             Await reader.GetValueAsync())
                Case XmlNodeType.EndElement
                    Console.WriteLine("End Element {0}", reader.Name)
                Case Else
                    Console.WriteLine("Other node {0} with value {1}",
                                    reader.NodeType, reader.Value)
            End Select
        End While
    End Using
End Function

Açıklamalar

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

Oluşturucular

Name	Description
XmlReader()	XmlReader sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
AttributeCount	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli düğümdeki özniteliklerin sayısını alır.
BaseURI	Türetilmiş bir sınıfta geçersiz kılındığında geçerli düğümün temel URI'sini alır.
CanReadBinaryContent	öğesinin ikili içerik okuma yöntemlerini uygulayıp uygulamadığını XmlReader belirten bir değer alır.
CanReadValueChunk	yönteminin XmlReader uygulanıp uygulanmadığını ReadValueChunk(Char[], Int32, Int32) belirten bir değer alır.
CanResolveEntity	Bu okuyucuya varlıkları ayrıştırıp çözümleyip çözümleyemeyeceğini gösteren bir değer alır.
Depth	Türetilmiş bir sınıfta geçersiz kılındığında, XML belgesindeki geçerli düğümün derinliğini alır.
EOF	Türetilmiş bir sınıfta geçersiz kılındığında, okuyucunun akışın sonunda konumlandırılıp konumlandırılmadığını belirten bir değer alır.
HasAttributes	Geçerli düğümün öznitelikleri olup olmadığını belirten bir değer alır.
HasValue	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli düğümün bir olup olmadığını belirten bir Valuedeğer alır.
IsDefault	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli düğümün DTD veya şemada tanımlanan varsayılan değerden oluşturulmuş bir öznitelik olup olmadığını belirten bir değer alır.
IsEmptyElement	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli düğümün boş bir öğe olup olmadığını belirten bir değer alır (örneğin, <MyElement/>).
Item[Int32]	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizine sahip özniteliğin değerini alır.
Item[String, String]	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen LocalName ve NamespaceURIile özniteliğinin değerini alır.
Item[String]	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen Nameile özniteliğinin değerini alır.
LocalName	Türetilmiş bir sınıfta geçersiz kılındığında geçerli düğümün yerel adını alır.
Name	Türetilmiş bir sınıfta geçersiz kılındığında geçerli düğümün tam adını alır.
NamespaceURI	Türetilmiş bir sınıfta geçersiz kılındığında, okuyucunun konumlandırıldığı düğümün ad alanı URI'sini (W3C Ad Alanı belirtiminde tanımlandığı gibi) alır.
NameTable	Türetilmiş bir sınıfta geçersiz kılındığında, bu uygulamayla ilişkili alır XmlNameTable .
NodeType	Türetilmiş bir sınıfta geçersiz kılındığında geçerli düğümün türünü alır.
Prefix	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli düğümle ilişkili ad alanı ön ekini alır.
QuoteChar	Türetilmiş bir sınıfta geçersiz kılındığında, öznitelik düğümünün değerini içine almak için kullanılan tırnak işareti karakterini alır.
ReadState	Türetilmiş bir sınıfta geçersiz kılındığında okuyucunun durumunu alır.
SchemaInfo	Şema doğrulamasının bir sonucu olarak geçerli düğüme atanmış şema bilgilerini alır.
Settings	XmlReaderSettings Bu XmlReader örneği oluşturmak için kullanılan nesneyi alır.
Value	Türetilmiş bir sınıfta geçersiz kılındığında geçerli düğümün metin değerini alır.
ValueType	Geçerli düğüm için Ortak Dil Çalışma Zamanı (CLR) türünü 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ı alır.

Yöntemler

Name	Description
Close()	Türetilmiş bir sınıfta geçersiz kılındığında, öğesini ReadState olarak Closeddeğiştirir.
Create(Stream, XmlReaderSettings, String)	Belirtilen akışı, temel URI'yi ve ayarları kullanarak yeni XmlReader bir örnek oluşturur.
Create(Stream, XmlReaderSettings, XmlParserContext)	Ayrıştırma için belirtilen akışı, ayarları ve bağlam bilgilerini kullanarak yeni XmlReader bir örnek oluşturur.
Create(Stream, XmlReaderSettings)	Belirtilen akış ve ayarlarla yeni XmlReader bir örnek oluşturur.
Create(Stream)	Varsayılan ayarlarla belirtilen akışı kullanarak yeni XmlReader bir örnek oluşturur.
Create(String, XmlReaderSettings, XmlParserContext)	Ayrıştırma için belirtilen URI'yi, ayarları ve bağlam bilgilerini kullanarak yeni XmlReader bir örnek oluşturur.
Create(String, XmlReaderSettings)	Belirtilen URI'yi ve ayarları kullanarak yeni XmlReader bir örnek oluşturur.
Create(String)	Belirtilen URI ile yeni XmlReader bir örnek oluşturur.
Create(TextReader, XmlReaderSettings, String)	Belirtilen metin okuyucuyu, ayarları ve temel URI'yi kullanarak yeni XmlReader bir örnek oluşturur.
Create(TextReader, XmlReaderSettings, XmlParserContext)	Ayrıştırma için belirtilen metin okuyucuyu, ayarları ve bağlam bilgilerini kullanarak yeni XmlReader bir örnek oluşturur.
Create(TextReader, XmlReaderSettings)	Belirtilen metin okuyucuyu ve ayarları kullanarak yeni XmlReader bir örnek oluşturur.
Create(TextReader)	Belirtilen metin okuyucuyu kullanarak yeni XmlReader bir örnek oluşturur.
Create(XmlReader, XmlReaderSettings)	Belirtilen XML okuyucuyu ve ayarları kullanarak yeni XmlReader bir örnek oluşturur.
Dispose()	Sınıfın geçerli örneği XmlReader tarafından kullanılan tüm kaynakları serbest bırakır.
Dispose(Boolean)	tarafından XmlReader kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetAttribute(Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizine sahip özniteliğin değerini alır.
GetAttribute(String, String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen LocalName ve NamespaceURIile özniteliğinin değerini alır.
GetAttribute(String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen Nameile özniteliğinin değerini alır.
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)
GetValueAsync()	Geçerli düğümün değerini zaman uyumsuz olarak alır.
IsName(String)	Dize bağımsız değişkeninin geçerli bir XML adı olup olmadığını gösteren bir değer döndürür.
IsNameToken(String)	Dize bağımsız değişkeninin geçerli bir XML adı belirteci olup olmadığını belirten bir değer döndürür.
IsStartElement()	Geçerli içerik düğümü bir başlangıç etiketi veya boş öğe etiketiyse çağrılar MoveToContent() ve testler.
IsStartElement(String, String)	Geçerli içerik düğümünün bir başlangıç etiketi veya boş öğe etiketi olup olmadığını ve bulunan öğenin ve MoveToContent() özelliklerinin verilen dizelerle eşleşip eşleşmediğini LocalName çağırır NamespaceURI ve test eder.
IsStartElement(String)	Geçerli içerik düğümünün bir başlangıç etiketi veya boş öğe etiketi olup olmadığını ve bulunan öğenin özelliğinin verilen bağımsız değişkenle eşleşip eşleşmediğini MoveToContent() çağırır Name ve test eder.
LookupNamespace(String)	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli öğenin kapsamındaki bir ad alanı ön ekini çözümler.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
MoveToAttribute(Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizine sahip özniteliğine geçer.
MoveToAttribute(String, String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen LocalName ve NamespaceURIile özniteliğine geçer.
MoveToAttribute(String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen Nameile özniteliğine geçer.
MoveToContent()	Geçerli düğümün bir içerik (boşluk olmayan metin, CDATA, , Element, EndElementEntityReferenceveya EndEntity) düğümü olup olmadığını denetler. Düğüm bir içerik düğümü değilse okuyucu sonraki içerik düğümüne veya dosyanın sonuna atlar. Şu türdeki düğümleri atlar: ProcessingInstruction, DocumentType, Comment, Whitespaceveya SignificantWhitespace.
MoveToContentAsync()	Geçerli düğümün bir içerik düğümü olup olmadığını zaman uyumsuz olarak denetler. Düğüm bir içerik düğümü değilse okuyucu sonraki içerik düğümüne veya dosyanın sonuna atlar.
MoveToElement()	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli öznitelik düğümünü içeren öğeye geçer.
MoveToFirstAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, ilk özniteliğe geçer.
MoveToNextAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, sonraki özniteliğe geçer.
Read()	Türetilmiş bir sınıfta geçersiz kılındığında, akıştan sonraki düğümü okur.
ReadAsync()	Akıştan bir sonraki düğümü zaman uyumsuz olarak okur.
ReadAttributeValue()	Türetilmiş bir sınıfta geçersiz kılındığında, öznitelik değerini bir veya daha fazla Text, EntityReferenceveya EndEntity düğüme ayrıştırılır.
ReadContentAs(Type, IXmlNamespaceResolver)	İçeriği belirtilen türde bir nesne olarak okur.
ReadContentAsAsync(Type, IXmlNamespaceResolver)	İçeriği zaman uyumsuz olarak belirtilen türde bir nesne olarak okur.
ReadContentAsBase64(Byte[], Int32, Int32)	İçeriği okur ve Base64 kod çözme ikili baytlarını döndürür.
ReadContentAsBase64Async(Byte[], Int32, Int32)	İçeriği zaman uyumsuz olarak okur ve Base64 kod çözme ikili baytlarını döndürür.
ReadContentAsBinHex(Byte[], Int32, Int32)	İçeriği okur ve kodu çözülen ikili baytları döndürür BinHex .
ReadContentAsBinHexAsync(Byte[], Int32, Int32)	İçeriği zaman uyumsuz olarak okur ve çözülen ikili baytları BinHex döndürür.
ReadContentAsBoolean()	Geçerli konumdaki metin içeriğini olarak Booleanokur.
ReadContentAsDateTime()	Geçerli konumdaki metin içeriğini nesne DateTime olarak okur.
ReadContentAsDateTimeOffset()	Geçerli konumdaki metin içeriğini nesne DateTimeOffset olarak okur.
ReadContentAsDecimal()	Geçerli konumdaki metin içeriğini nesne Decimal olarak okur.
ReadContentAsDouble()	Geçerli konumdaki metin içeriğini çift duyarlıklı kayan noktalı sayı olarak okur.
ReadContentAsFloat()	Geçerli konumdaki metin içeriğini tek duyarlıklı kayan nokta numarası olarak okur.
ReadContentAsInt()	Geçerli konumdaki metin içeriğini 32 bit imzalı tamsayı olarak okur.
ReadContentAsLong()	Geçerli konumdaki metin içeriğini 64 bit imzalı tamsayı olarak okur.
ReadContentAsObject()	Geçerli konumdaki metin içeriğini olarak Objectokur.
ReadContentAsObjectAsync()	Geçerli konumdaki metin içeriğini zaman uyumsuz olarak olarak Objectokur.
ReadContentAsString()	Geçerli konumdaki metin içeriğini nesne String olarak okur.
ReadContentAsStringAsync()	Geçerli konumdaki metin içeriğini zaman uyumsuz olarak nesne String olarak okur.
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Belirtilen yerel adın ve ad alanı URI'sinin geçerli öğeyle eşleşip eşleşmediğini denetler, ardından öğe içeriğini istenen tür olarak okur.
ReadElementContentAs(Type, IXmlNamespaceResolver)	öğe içeriğini istenen tür olarak okur.
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)	öğe içeriğini istenen tür olarak zaman uyumsuz olarak okur.
ReadElementContentAsBase64(Byte[], Int32, Int32)	öğesini okur ve içeriğin kodunu Base64 çözer.
ReadElementContentAsBase64Async(Byte[], Int32, Int32)	Öğeyi zaman uyumsuz olarak okur ve içeriğin kodunu çözer Base64 .
ReadElementContentAsBinHex(Byte[], Int32, Int32)	öğesini okur ve içeriğin kodunu BinHex çözer.
ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)	Öğeyi zaman uyumsuz olarak okur ve içeriğin kodunu çözer BinHex .
ReadElementContentAsBoolean()	Geçerli öğeyi okur ve içeriğini nesne Boolean olarak döndürür.
ReadElementContentAsBoolean(String, String)	Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğeyle eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriği nesne Boolean olarak döndürür.
ReadElementContentAsDateTime()	Geçerli öğeyi okur ve içeriğini nesne DateTime olarak döndürür.
ReadElementContentAsDateTime(String, String)	Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğeyle eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriği nesne DateTime olarak döndürür.
ReadElementContentAsDecimal()	Geçerli öğeyi okur ve içeriğini nesne Decimal olarak döndürür.
ReadElementContentAsDecimal(String, String)	Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğeyle eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriği nesne Decimal olarak döndürür.
ReadElementContentAsDouble()	Geçerli öğeyi okur ve içeriğini çift duyarlıklı kayan noktalı sayı olarak döndürür.
ReadElementContentAsDouble(String, String)	Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğeyle eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriği çift duyarlıklı kayan noktalı sayı olarak döndürür.
ReadElementContentAsFloat()	Geçerli öğeyi okur ve içeriği tek duyarlıklı kayan nokta numarası olarak döndürür.
ReadElementContentAsFloat(String, String)	Belirtilen yerel adın ve ad alanı URI'sinin geçerli öğeyle eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriği tek duyarlıklı kayan noktalı sayı olarak döndürür.
ReadElementContentAsInt()	Geçerli öğeyi okur ve içeriği 32 bit imzalı tamsayı olarak döndürür.
ReadElementContentAsInt(String, String)	Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğeyle eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriği 32 bit imzalı bir tamsayı olarak döndürür.
ReadElementContentAsLong()	Geçerli öğeyi okur ve içeriği 64 bit imzalı tamsayı olarak döndürür.
ReadElementContentAsLong(String, String)	Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğeyle eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriği 64 bit imzalı bir tamsayı olarak döndürür.
ReadElementContentAsObject()	Geçerli öğeyi okur ve içeriğini olarak Objectdöndürür.
ReadElementContentAsObject(String, String)	Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğeyle eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriğini olarak Objectdöndürür.
ReadElementContentAsObjectAsync()	Geçerli öğeyi zaman uyumsuz olarak okur ve içeriğini olarak Objectdöndürür.
ReadElementContentAsString()	Geçerli öğeyi okur ve içeriğini nesne String olarak döndürür.
ReadElementContentAsString(String, String)	Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğeyle eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriği nesne String olarak döndürür.
ReadElementContentAsStringAsync()	Geçerli öğeyi zaman uyumsuz olarak okur ve içeriği nesne String olarak döndürür.
ReadElementString()	Salt metin öğesini okur. Ancak, bu işlemi işlemek için daha kolay bir yol sağladığından yöntemini kullanmanızı ReadElementContentAsString() öneririz.
ReadElementString(String, String)	Bulunan öğenin ve LocalName özelliklerinin, yalnızca metin içeren bir öğeyi okumadan önce verilen dizelerle eşleşip eşleşmediğini NamespaceURI denetler. Ancak, bu işlemi işlemek için daha kolay bir yol sağladığından yöntemini kullanmanızı ReadElementContentAsString(String, String) öneririz.
ReadElementString(String)	Name Bulunan öğenin özelliğinin, yalnızca metin içeren bir öğeyi okumadan önce verilen dizeyle eşleştiğini denetler. Ancak, bu işlemi işlemek için daha kolay bir yol sağladığından yöntemini kullanmanızı ReadElementContentAsString() öneririz.
ReadEndElement()	Geçerli içerik düğümünü bir bitiş etiketi olup olmadığını denetler ve okuyucuyu sonraki düğüme ilerler.
ReadInnerXml()	Türetilmiş bir sınıfta geçersiz kılındığında, işaretleme de dahil olmak üzere tüm içeriği dize olarak okur.
ReadInnerXmlAsync()	İşaretleme de dahil olmak üzere tüm içeriği zaman uyumsuz olarak dize olarak okur.
ReadOuterXml()	Türetilmiş bir sınıfta geçersiz kılındığında, bu düğümü ve tüm alt öğelerini temsil eden işaretleme de dahil olmak üzere içeriği okur.
ReadOuterXmlAsync()	bu düğümü ve tüm alt öğelerini temsil eden işaretleme de dahil olmak üzere içeriği zaman uyumsuz olarak okur.
ReadStartElement()	Geçerli düğümün bir öğe olduğunu denetler ve okuyucuyu sonraki düğüme ilerler.
ReadStartElement(String, String)	Geçerli içerik düğümünü verilen LocalName ile bir öğe olup olmadığını denetler ve NamespaceURI okuyucuyu sonraki düğüme ilerler.
ReadStartElement(String)	Geçerli içerik düğümünü verilen Name bir öğe olup olmadığını denetler ve okuyucuyu sonraki düğüme ilerler.
ReadString()	Türetilmiş bir sınıfta geçersiz kılındığında, bir öğenin veya metin düğümünün içeriğini dize olarak okur. Ancak, bu işlemi işlemek için daha kolay bir yol sağladığından yöntemini kullanmanızı ReadElementContentAsString öneririz.
ReadSubtree()	Geçerli düğümü ve tüm alt öğeleri okumak için kullanılabilecek yeni XmlReader bir örnek döndürür.
ReadToDescendant(String, String)	öğesini belirtilen yerel ad ve ad alanı URI'siyle sonraki alt öğeye ilerler XmlReader .
ReadToDescendant(String)	öğesini belirtilen nitelenmiş adla sonraki alt öğeye ilerler XmlReader .
ReadToFollowing(String, String)	Belirtilen yerel ada ve ad alanı URI'sine sahip bir öğe bulunana kadar okur.
ReadToFollowing(String)	Belirtilen nitelenmiş ada sahip bir öğe bulunana kadar okur.
ReadToNextSibling(String, String)	belirtilen yerel ad ve ad alanı URI'siyle öğesini sonraki eşdüzey öğeye ilerler XmlReader .
ReadToNextSibling(String)	öğesini belirtilen nitelenmiş ada sahip bir sonraki eşdüzey öğeye ilerler XmlReader .
ReadValueChunk(Char[], Int32, Int32)	XML belgesine eklenmiş büyük metin akışlarını okur.
ReadValueChunkAsync(Char[], Int32, Int32)	XML belgesine eklenmiş büyük metin akışlarını zaman uyumsuz olarak okur.
ResolveEntity()	Türetilmiş bir sınıfta geçersiz kılındığında düğümler için EntityReference varlık başvurularını çözümler.
Skip()	Geçerli düğümün alt öğelerini atlar.
SkipAsync()	Geçerli düğümün alt öğelerini zaman uyumsuz olarak atlar.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• XML Belgeleri ve Verileri