XmlReader.ReadElementContentAsDateTime Metod

Definition

Namnområde:
System.Xml
Sammansättningar:
netstandard.dll, System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.dll
Sammansättning:
netstandard.dll

Läser det aktuella elementet och returnerar innehållet som ett DateTime objekt.

Överlagringar

Name Description
ReadElementContentAsDateTime()

Läser det aktuella elementet och returnerar innehållet som ett DateTime objekt.
ReadElementContentAsDateTime(String, String)

Kontrollerar att det angivna lokala namnet och namnområdes-URI:n matchar det aktuella elementets, läser det aktuella elementet och returnerar innehållet som ett DateTime objekt.

ReadElementContentAsDateTime()

Källa:
XmlReader.cs
Källa:
XmlReader.cs
Källa:
XmlReader.cs
Källa:
XmlReader.cs
Källa:
XmlReader.cs

Läser det aktuella elementet och returnerar innehållet som ett DateTime objekt.

public:
 virtual DateTime ReadElementContentAsDateTime();
public virtual DateTime ReadElementContentAsDateTime();
abstract member ReadElementContentAsDateTime : unit -> DateTime
override this.ReadElementContentAsDateTime : unit -> DateTime
Public Overridable Function ReadElementContentAsDateTime () As DateTime

Returer

DateTime

Elementinnehållet som ett DateTime objekt.

Undantag

InvalidOperationException

XmlReader Är inte placerad på ett element.

-eller-

En XmlReader metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

XmlException

Det aktuella elementet innehåller underordnade element.

-eller-

Elementinnehållet kan inte konverteras till ett DateTime objekt.

ArgumentNullException

Metoden anropas med null argument.

Exempel

I följande exempel används ReadElementContentAsDateTime metoden för att läsa innehållet i elementet date .

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

I exemplet används dataFile.xml filen som indata.

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

Kommentarer

Den här metoden läser starttaggen, innehållet i elementet och flyttar läsaren förbi taggen slutelement. Den expanderar entiteter och ignorerar bearbetningsinstruktioner och kommentarer. Elementet kan bara innehålla enkelt innehåll. Den kan alltså inte ha underordnade element.

Om innehållet skrivs xsd:dateTimereturnerar läsaren ett oboxat DateTime objekt. Om innehållet inte skrivs xsd:dateTimeförsöker läsaren konvertera det till ett DateTime objekt enligt de regler som definierats i W3C XML-schema del 2: Rekommendationen Datatypes .

Note

Du kan inte lita på värdet DateTime.Year när innehållet skrivs som xsd:gMonthDay. XmlReader anger DateTime.Year alltid värdet till 1904 i det här fallet.

Mer information finns i avsnittet Kommentarer på XmlReader referenssidan.

Gäller för

ReadElementContentAsDateTime(String, String)

Källa:
XmlReader.cs
Källa:
XmlReader.cs
Källa:
XmlReader.cs
Källa:
XmlReader.cs
Källa:
XmlReader.cs

Kontrollerar att det angivna lokala namnet och namnområdes-URI:n matchar det aktuella elementets, läser det aktuella elementet och returnerar innehållet som ett DateTime objekt.

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

Parametrar

localName
String

Elementets lokala namn.

namespaceURI
String

Elementets namnområdes-URI.

Returer

DateTime

Elementinnehållet som ett DateTime objekt.

Undantag

InvalidOperationException

XmlReader Är inte placerad på ett element.

-eller-

En XmlReader metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

XmlException

Det aktuella elementet innehåller underordnade element.

-eller-

Elementinnehållet kan inte konverteras till den begärda typen.

ArgumentNullException

Metoden anropas med null argument.

ArgumentException

Det angivna lokala namnet och namnområdes-URI:n matchar inte det aktuella element som läses.

Kommentarer

Den här metoden läser starttaggen, innehållet i elementet och flyttar läsaren förbi taggen slutelement. Den expanderar entiteter och ignorerar bearbetningsinstruktioner och kommentarer. Elementet kan bara innehålla enkelt innehåll. Den kan alltså inte ha underordnade element.

Om innehållet skrivs xsd:dateTimereturnerar läsaren ett oboxat DateTime objekt. Om innehållet inte skrivs xsd:dateTimeförsöker läsaren konvertera det till ett DateTime objekt enligt de regler som definierats i W3C XML-schema del 2: Rekommendationen Datatypes .

Note

Du kan inte lita på värdet DateTime.Year när innehållet skrivs som xsd:gMonthDay. XmlReader anger DateTime.Year alltid värdet till 1904 i det här fallet.

Mer information finns i avsnittet Kommentarer på XmlReader referenssidan.

Gäller för