XmlReader.ReadElementContentAsDateTime 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ğini nesne DateTime olarak döndürür.

Aşırı Yüklemeler

Name	Description
ReadElementContentAsDateTime()	Geçerli öğeyi okur ve içeriğini nesne DateTime olarak döndürür.
ReadElementContentAsDateTime(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 nesne DateTime olarak döndürür.

ReadElementContentAsDateTime()

Kaynak:

XmlReader.cs

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

public:
 virtual DateTime ReadElementContentAsDateTime();

public virtual DateTime ReadElementContentAsDateTime();

abstract member ReadElementContentAsDateTime : unit -> DateTime
override this.ReadElementContentAsDateTime : unit -> DateTime

Public Overridable Function ReadElementContentAsDateTime () As DateTime

Döndürülenler

DateTime

Nesne olarak DateTime öğ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 bir DateTime nesneye dönüştürülemez.

ArgumentNullException

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

Örnekler

Aşağıdaki örnek, öğesinin ReadElementContentAsDateTime içeriğini date okumak için yöntemini kullanır.

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("date");
     DateTime date = reader.ReadElementContentAsDateTime();
  
     // 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 = reader.ReadElementContentAsDateTime()
            
  ' 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.

İçerik yazılırsa xsd:dateTimeokuyucu, kutulanmamış DateTime bir nesne döndürür. İçerik yazılmamışsaxsd:dateTime, okuyucu bunu W3C XML Şema Bölüm 2: Veri Türleri önerisi tarafından tanımlanan kurallara göre bir DateTime nesneye dönüştürmeyi dener.

Note

DateTime.Year değeri, içerik olarak xsd:gMonthDay yazıldığında güvenilir değildir. XmlReader bu durumda her zaman değeri 1904 olarak ayarlar DateTime.Year .

Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlReader bakın.

ReadElementContentAsDateTime(String, String)

Kaynak:

XmlReader.cs

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 nesne DateTime olarak döndürür.

public:
 virtual DateTime ReadElementContentAsDateTime(System::String ^ localName, System::String ^ namespaceURI);

public virtual DateTime ReadElementContentAsDateTime(string localName, string namespaceURI);

abstract member ReadElementContentAsDateTime : string * string -> DateTime
override this.ReadElementContentAsDateTime : string * string -> DateTime

Public Overridable Function ReadElementContentAsDateTime (localName As String, namespaceURI As String) As DateTime

Parametreler

localName

String

Öğesinin yerel adı.

namespaceURI

String

öğesinin ad alanı URI'si.

Döndürülenler

DateTime

Öğe içeriği bir DateTime nesne olarak.

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

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.

İçerik yazılırsa xsd:dateTimeokuyucu, kutulanmamış DateTime bir nesne döndürür. İçerik yazılmamışsaxsd:dateTime, okuyucu bunu W3C XML Şema Bölüm 2: Veri Türleri önerisi tarafından tanımlanan kurallara göre bir DateTime nesneye dönüştürmeyi dener.

Note

DateTime.Year değeri, içerik olarak xsd:gMonthDay yazıldığında güvenilir değildir. XmlReader bu durumda her zaman değeri 1904 olarak ayarlar DateTime.Year .

Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlReader bakın.