XmlReader.ReadElementContentAs Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

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

Aşırı Yüklemeler

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 öğenin adıyla eşleşip eşleşmediğini denetler, ardından istenen tür olarak öğe içeriğini okur.

ReadElementContentAs(Type, IXmlNamespaceResolver)

Kaynak:

XmlReader.cs

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

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver);

public virtual object ReadElementContentAs (Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver);

abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj

Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver) As Object

Parametreler

returnType

Type

Döndürülecek değerin türü.

Not .NET Framework 3.5 sürümüyle, parametrenin returnType değeri artık türü olabilirDateTimeOffset.

namespaceResolver

IXmlNamespaceResolver

IXmlNamespaceResolver Tür dönüştürmeyle ilgili ad alanı ön eklerini çözümlemek için kullanılan nesne.

Döndürülenler

Object

İstenen yazılan nesneye dönüştürülen öğe içeriği.

Özel durumlar

InvalidOperationException

XmlReader öğesinde konumlandırılmaz.

-veya-

Ö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.

XmlException

Geçerli öğe alt öğeleri içerir.

-veya-

Öğe içeriği istenen türe dönüştürülemez.

ArgumentNullException

yöntemi bağımsız değişkenlerle null çağrılır.

OverflowException

okuyun Decimal.MaxValue.

Örnekler

Aşağıdaki örnek, düğümün ReadElementContentAs içeriğini date okumak için yöntemini kullanır.

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("date");
     DateTime date = (DateTime) reader.ReadElementContentAs(typeof(System.DateTime), null);
  
     // If the current culture is "en-US",
     // this writes "Wednesday, January 8, 2003".
     Console.WriteLine(date.ToLongDateString());	
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("date")
  Dim [date] As DateTime = CType(reader.ReadElementContentAs(GetType(System.DateTime), Nothing), DateTime)
            
  ' If the current culture is "en-US",
  ' this writes "Wednesday, January 8, 2003".
  Console.WriteLine([date].ToLongDateString())
End Using

Örnek, giriş olarak dosyasını kullanır dataFile.xml .

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Açıklamalar

Bu yöntem başlangıç etiketini, öğesinin içeriğini okur ve okuyucuyu bitiş öğesi etiketinin dışına taşır. Varlıkları genişletir ve işleme yönergelerini ve açıklamalarını yoksayar. öğesi yalnızca basit içerik içerebilir. Başka bir ifadeyle, alt öğeleri olamaz.

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 ReadElementContentAsAsync. .

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Kaynak:

XmlReader.cs

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

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver, System::String ^ localName, System::String ^ namespaceURI);

public virtual object ReadElementContentAs (Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver, string localName, string namespaceURI);

abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj

Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver, localName As String, namespaceURI As String) As Object

Parametreler

returnType

Type

Döndürülecek değerin türü.

Not .NET Framework 3.5 sürümüyle, parametrenin returnType değeri artık türü olabilirDateTimeOffset.

namespaceResolver

IXmlNamespaceResolver

IXmlNamespaceResolver Tür dönüştürmeyle ilgili ad alanı ön eklerini çözümlemek için kullanılan nesne.

localName

String

Öğesinin yerel adı.

namespaceURI

String

öğesinin ad alanı URI'si.

Döndürülenler

Object

İstenen yazılan nesneye dönüştürülen öğe içeriği.

Özel durumlar

InvalidOperationException

XmlReader öğesinde konumlandırılmaz.

-veya-

Ö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.

XmlException

Geçerli öğe alt öğeleri içerir.

-veya-

Öğe içeriği istenen türe dönüştürülemez.

ArgumentNullException

yöntemi bağımsız değişkenlerle null çağrılır.

ArgumentException

Belirtilen yerel ad ve ad alanı URI'si okunan geçerli öğenin adıyla eşleşmiyor.

OverflowException

okuyun Decimal.MaxValue.

Açıklamalar

Bu yöntem başlangıç etiketini, öğesinin içeriğini okur ve okuyucuyu bitiş öğesi etiketinin dışına taşır. Varlıkları genişletir ve işleme yönergelerini ve açıklamalarını yoksayar. öğesi yalnızca basit içerik içerebilir. Başka bir ifadeyle, alt öğeleri olamaz.

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.