XmlReader.ReadElementContentAsDateTime Yöntem

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

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

Aşırı Yüklemeler

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 öğenin adıyla 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()

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

Örnekte giriş olarak dosya kullanılı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 son öğe 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. Yani, 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.

Not

İçerik olarak xsd:gMonthDayyazıldığında değerine güvenemezsinizDateTime.Year. 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)

Belirtilen yerel ad ve ad alanı URI'sinin geçerli öğenin adıyla 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 öğenin adıyla eşleşmiyor.

Açıklamalar

Bu yöntem başlangıç etiketini, öğesinin içeriğini okur ve okuyucuyu son öğe 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. Yani, 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.

Not

İçerik olarak xsd:gMonthDayyazıldığında değerine güvenemezsinizDateTime.Year. 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.