XmlReader.ReadContentAsString 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

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Ö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 nesne String olarak okur.

public:
 virtual System::String ^ ReadContentAsString();

public virtual string ReadContentAsString ();

abstract member ReadContentAsString : unit -> string
override this.ReadContentAsString : unit -> string

Public Overridable Function ReadContentAsString () As String

Döndürülenler

String

Nesne olarak String 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.

Bu yöntem, yazılan değerleri dizeye dönüştürmek veya açıklamaları ve işleme yönergelerini atlarken metin içeriğini okumak için kullanılabilir.

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

Xmlnodetype	Döndürülen değer	Okuyucu davranışı
`Text` `CDATA` `Whitespace` `SignificantWhitespace` `EntityReference` `EndEntity`	Metin, CDATA, boşluk ve önemli boşluk düğümlerinin birleştirilmiş içeriği istenen türe dönüştürülür.	Sonraki başlangıç öğesine veya bitiş öğesi etiketine geçer. Varlık başvuruları otomatik olarak genişletilir.
`Attribute`	Öznitelik değerini çağırmakla `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`	Boş bir dize.	Okuyucu geçerli konumda kalır.
`Element` `XmlDeclaration` `None` `Document` `DocumentType` `Notation` `Entity` `DocumentFragment`	bir InvalidOperationException atılır.	Tanımlanmamış olsa da, okuyucu genellikle 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 ReadContentAsStringAsync. .

Şunlara uygulanır