XmlReader.ReadContentAsObject Yöntem

Başvuru

Tanım

Ad Alanı:: System.Xml

Bütünleştirilmiş Kod:: System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:: System.Xml.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Geçerli konumdaki metin içeriğini olarak Objectokur.

public:
 virtual System::Object ^ ReadContentAsObject();

public virtual object ReadContentAsObject ();

abstract member ReadContentAsObject : unit -> obj
override this.ReadContentAsObject : unit -> obj

Public Overridable Function ReadContentAsObject () As Object

Döndürülenler

Object

En uygun ortak dil çalışma zamanı (CLR) nesnesi olarak metin içeriği.

Özel durumlar

InvalidCastException

Denenen atama geçerli değil.

FormatException

Dize biçimi geçerli değil.

InvalidOperationException

Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Açıklamalar

Bu yöntem metin, boşluk, önemli boşluk ve CDATA bölümlerini birleştirir ve açıklamaları veya işleme yönergelerini atlar. Varlık başvuruları otomatik olarak çözümlenir.

İçerik yazıldıysa, okuyucu özelliği tarafından ValueType belirtilen en uygun türde kutulanmış bir CLR döndürür. İçerik bir liste türündeyse, okuyucu uygun türde kutulu nesneler dizisi döndürür.

Not

İçerik ayrıştırılırken doğrulama hatası oluşursa ve okuyucu yöntemi tarafından Create oluşturulan bir XmlReader nesneyse, okuyucu içeriği dize olarak döndürür. Başka bir deyişle, bir doğrulama hatası veya uyarısı oluştuğunda, içerik yazılmamış olarak kabul edilir.

İçerik yazılmazsa, okuyucu içeriği dize olarak döndürür.

Aşağıdaki tabloda bu yöntemin her düğüm türüne nasıl davrandığı açıklanmaktadır.

Xmlnodetype	Döndürülen değer	Okuyucu davranışı
`Text` `CDATA` `Whitespace` `SignificantWhitespace` `EntityReference` `EndEntity`	Metin, CDATA, boşluk ve istenen türe dönüştürülen önemli boşluk düğümlerinin birleştirilmiş içeriği.	Sonraki başlangıç öğesine veya bitiş öğesi etiketine geçer. Varlık başvuruları otomatik olarak genişletilir.
`Attribute`	Öznitelik değerinde çağırmayla `XmlConvert.ToXxx` aynı.	Okuyucu geçerli konumda kalır
`Comment` `ProcessingInstruction`	İşleme yönergesini (PI) veya açıklamayı yoksayar ve PI veya açıklamayı izleyen birleştirilmiş metin içeriğini okur.	Sonraki başlangıç öğesine veya bitiş öğesi etiketine geçer. Varlık başvuruları otomatik olarak genişletilir.
`EndElement`	Okuyucu bir şema doğrulama okuyucusuysa (ValidationType olarak ayarlanır Schema) öğesinin değeri; aksi takdirde boş bir dizedir.	Okuyucu geçerli konumda kalır.
`Element` `XmlDeclaration` `None` `Document` `DocumentType` `Notation` `Entity` `DocumentFragment`	bir InvalidOperationException atılır.	Tanımsız, ancak genellikle okuyucu geçerli konumda kalır.

Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlReader ve W3C XML Şema Bölüm 2: Veri türleri önerisine bakın.

Bu yöntemin zaman uyumsuz sürümü için bkz ReadContentAsObjectAsync. .

Şunlara uygulanır

Share via