XmlReader.ReadElementContentAs Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, 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

Name	Description
ReadElementContentAs(Type, IXmlNamespaceResolver)	öğe içeriğini istenen tür 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)

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, parametresinin returnType değeri artık türü olabilir DateTimeOffset .

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

öğesini 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, girdi 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ı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.

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, parametresinin returnType değeri artık türü olabilir DateTimeOffset .

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 öğeyle eşleşmiyor.

OverflowException

öğesini 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.