XmlReader Sınıf

Tanım

XML verilerine hızlı, önbelleğe alınmamış, yalnızca ileriye doğru erişim sağlayan bir okuyucuyu temsil eder.

public ref class XmlReader abstract : IDisposable
public ref class XmlReader abstract
public abstract class XmlReader : IDisposable
public abstract class XmlReader
type XmlReader = class
    interface IDisposable
type XmlReader = class
Public MustInherit Class XmlReader
Implements IDisposable
Public MustInherit Class XmlReader
Devralma
XmlReader
Türetilmiş
Uygulamalar

Ö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

XmlReader()

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

Özellikler

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

ikili içerik okuma yöntemlerini uygulayıp uygulamadığını XmlReader belirten bir değer alır.

CanReadValueChunk

yöntemini uygulayıp uygulamadığını XmlReaderReadValueChunk(Char[], Int32, Int32) belirten bir değer alır.

CanResolveEntity

Bu okuyucu tarafından varlıkları ayrıştırıp çözümleyemeyeceğini belirten 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 NamespaceURIö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

Close()

Türetilmiş bir sınıfta geçersiz kılındığında, öğesini ReadState olarak Closeddeğiştirir.

Create(Stream)

Varsayılan ayarlarla belirtilen akışı kullanarak yeni XmlReader bir örnek oluşturur.

Create(Stream, XmlReaderSettings)

Belirtilen akış ve ayarlarla yeni XmlReader bir örnek oluşturur.

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(String)

Belirtilen URI ile yeni XmlReader bir örnek oluşturur.

Create(String, XmlReaderSettings)

Belirtilen URI'yi ve ayarları 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(TextReader)

Belirtilen metin okuyucuyu kullanarak yeni XmlReader bir örnek oluşturur.

Create(TextReader, XmlReaderSettings)

Belirtilen metin okuyucuyu ve ayarları kullanarak 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(XmlReader, XmlReaderSettings)

Belirtilen XML okuyucuyu ve ayarları kullanarak yeni XmlReader bir örnek oluşturur.

Dispose()

XmlReader sınıfının geçerli örneği tarafından kullanılan tüm kaynakları serbest bırakır.

Dispose(Boolean)

XmlReader tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak 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)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen Nameile özniteliğinin değerini alır.

GetAttribute(String, String)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen LocalName ve NamespaceURIözniteliğinin değerini alır.

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)
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ı belirten 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)

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 Name çağırır MoveToContent() ve test eder.

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 NamespaceURI özelliklerinin verilen dizelerle eşleşip eşleşmediğini LocalName çağırır MoveToContent() 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 Objectöğesinin sığ 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)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen Nameile özniteliğine taşınır.

MoveToAttribute(String, String)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen LocalName ve NamespaceURIile özniteliğine taşınır.

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üğümler üzerinden 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üğümde ayrıştırın.

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ı BinHex döndürür.

ReadContentAsBinHexAsync(Byte[], Int32, Int32)

İçeriği zaman uyumsuz olarak okur ve kodu çö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)

öğe içeriğini istenen tür olarak okur.

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğeninkiyle eşleşip eşleşmediğini denetler, ardından öğ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 öğenin adıyla 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ği bir DateTime nesne olarak döndürür.

ReadElementContentAsDateTime(String, String)

Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğenin adıyla eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriği bir DateTime nesne olarak döndürür.

ReadElementContentAsDecimal()

Geçerli öğeyi okur ve içeriği bir Decimal nesne olarak döndürür.

ReadElementContentAsDecimal(String, String)

Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğenin adıyla eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriği bir Decimal nesne olarak döndürür.

ReadElementContentAsDouble()

Geçerli öğeyi okur ve içeriği ç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 noktalı sayı olarak döndürür.

ReadElementContentAsFloat(String, String)

Belirtilen yerel adın ve ad alanı URI'sinin geçerli öğenin adıyla 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 öğenin adıyla eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriği 32 bit imzalı tamsayı olarak döndürür.

ReadElementContentAsLong()

Geçerli öğeyi okur ve içeriği 64 bit işaretli tamsayı olarak döndürür.

ReadElementContentAsLong(String, String)

Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğenin adıyla eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriği 64 bit imzalı 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 öğenin adıyla 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ği bir String nesne olarak döndürür.

ReadElementContentAsString(String, String)

Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğenin adıyla eşleşip eşleşmediğini denetler, ardından geçerli öğeyi okur ve içeriği bir String nesne olarak döndürür.

ReadElementContentAsStringAsync()

Geçerli öğeyi zaman uyumsuz olarak okur ve içeriği bir String nesne 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)

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.

ReadElementString(String, String)

Bulunan öğenin ve NamespaceURI özelliklerinin yalnızca metin içeren bir öğeyi okumadan önce verilen dizelerle eşleştiğini LocalName denetler. Ancak, bu işlemi işlemek için daha kolay bir yol sağladığından yöntemini kullanmanızı ReadElementContentAsString(String, String) ö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 bir 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)

Geçerli içerik düğümünü verilen Name bir öğe olup olmadığını denetler ve okuyucuyu sonraki düğüme ilerler.

ReadStartElement(String, String)

Geçerli içerik düğümünü verilen LocalName bir öğe olup olmadığını denetler ve NamespaceURI 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)

belirtilen nitelenmiş ada sahip sonraki alt öğeye ilerler XmlReader .

ReadToDescendant(String, String)

belirtilen yerel ad ve ad alanı URI'siyle öğesini sonraki alt öğeye ilerler XmlReader .

ReadToFollowing(String)

Belirtilen nitelenmiş ada sahip bir öğe bulunana kadar okur.

ReadToFollowing(String, String)

Belirtilen yerel ada ve ad alanı URI'sine sahip bir öğe bulunana kadar okur.

ReadToNextSibling(String)

belirtilen XmlReader nitelenmiş ada sahip bir sonraki eşdüzey öğeye ilerler.

ReadToNextSibling(String, String)

belirtilen yerel ad ve ad alanı URI'sine 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 dizeyi döndürür.

(Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

IDisposable.Dispose()

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

Şunlara uygulanır

Ayrıca bkz.