XmlConvert.ToDateTime Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Konvertiert den String in ein DateTime-Äquivalent.

Überlädt

ToDateTime(String)	Veraltet. Konvertiert den String in ein DateTime-Äquivalent.
ToDateTime(String, String)	Konvertiert den String in ein DateTime-Äquivalent.
ToDateTime(String, String[])	Konvertiert den String in ein DateTime-Äquivalent.
ToDateTime(String, XmlDateTimeSerializationMode)	Konvertiert die String-Struktur mithilfe von XmlDateTimeSerializationMode in eine DateTime.

ToDateTime(String)

Quelle:

XmlConvert.cs

Achtung

Use XmlConvert.ToDateTime() that accepts an XmlDateTimeSerializationMode instead.

Konvertiert den String in ein DateTime-Äquivalent.

public:
 static DateTime ToDateTime(System::String ^ s);

[System.Obsolete("Use XmlConvert.ToDateTime() that accepts an XmlDateTimeSerializationMode instead.")]
public static DateTime ToDateTime (string s);

[<System.Obsolete("Use XmlConvert.ToDateTime() that accepts an XmlDateTimeSerializationMode instead.")>]
static member ToDateTime : string -> DateTime

Public Shared Function ToDateTime (s As String) As DateTime

Parameter

s

String

Die zu konvertierende Zeichenfolge.

Gibt zurück

DateTime

Ein DateTime-Äquivalent der Zeichenfolge.

Attribute

ObsoleteAttribute

Ausnahmen

ArgumentNullException

s ist null.

FormatException

s ist eine leere Zeichenfolge oder hat nicht das richtige Format.

Beispiele

Im folgenden Beispiel werden stark typisierte Daten verwendet ToDouble und ToDateTime gelesen.

#using <System.dll>
#using <System.xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlTextReader^ reader = gcnew XmlTextReader( "orderData.xml" );
   
   //Parse the file and pull out the order date and price.
   while ( reader->Read() )
   {
      if ( reader->NodeType == XmlNodeType::Element )
      {
         if ( reader->Name->Equals( "order" ) )
         {
            DateTime orderDate = XmlConvert::ToDateTime( reader->GetAttribute( "date" ) );
            Console::WriteLine( "order date: {0}", orderDate.ToString() );
         }
         else
         if ( reader->Name->Equals( "price" ) )
         {
            Double price = XmlConvert::ToDouble( reader->ReadInnerXml() );
            Console::WriteLine( "price: {0}", price );
         }
      }
   }

   
   //Close the reader.
   reader->Close();
}

using System;
using System.IO;
using System.Xml;

public class Sample
{

  public static void Main()
  {
    XmlTextReader reader = new XmlTextReader("orderData.xml");

    //Parse the file and pull out the order date and price.
    while (reader.Read()){
       if (reader.NodeType==XmlNodeType.Element){
         switch(reader.Name){
           case "order":
             DateTime orderDate = XmlConvert.ToDateTime(reader.GetAttribute("date"));
             Console.WriteLine("order date: {0}", orderDate.ToString());
             break;
           case "price":
             Double price = XmlConvert.ToDouble(reader.ReadInnerXml());
             Console.WriteLine("price: {0}", price.ToString());
             break;
         }
       }
    }

    //Close the reader.
    reader.Close();
  }
}

Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()
  
    Dim reader as XmlTextReader = new XmlTextReader("orderData.xml")

    'Parse the file and pull out the order date and price.
    while (reader.Read())
       if (reader.NodeType=XmlNodeType.Element)
         select case reader.Name
           case "order":
             Dim orderDate as DateTime = XmlConvert.ToDateTime(reader.GetAttribute("date"))
             Console.WriteLine("order date: {0}", orderDate.ToString())
           case "price":
             Dim price as Double = XmlConvert.ToDouble(reader.ReadInnerXml())
             Console.WriteLine("price: {0}", price.ToString())
         end select
       end if
    end while

    'Close the reader.
    reader.Close()  
  end sub
end class

Im Beispiel wird die Datei als orderData.xmlEingabe verwendet.

<order date="2001-05-03">
  <orderID>367A54</orderID>
  <custID>32632</custID>
  <price>19.95</price>
</order>

Hinweise

Hinweis

Die XmlConvert.ToDateTime(String) Methode ist in der Version 2.0 der .NET Framework veraltet und wurde durch die XmlConvert.ToDateTime(String, XmlDateTimeSerializationMode) -Methode ersetzt.

ToDateTime(String, String)

Quelle:

XmlConvert.cs

Konvertiert den String in ein DateTime-Äquivalent.

public:
 static DateTime ToDateTime(System::String ^ s, System::String ^ format);

public static DateTime ToDateTime (string s, string format);

static member ToDateTime : string * string -> DateTime

Public Shared Function ToDateTime (s As String, format As String) As DateTime

Parameter

s

String

Die zu konvertierende Zeichenfolge.

format

String

Die auf das konvertierte DateTime anzuwendende Formatstruktur. Zu den gültigen Format zählt „yyyy-MM-ddTHH:mm:sszzzzzz“ und dessen Teilmengen. Es wird validiert, ob die Zeichenfolge dieses Format aufweist.

Gibt zurück

DateTime

Ein DateTime-Äquivalent der Zeichenfolge.

Ausnahmen

ArgumentNullException

s ist null.

FormatException

s oder format ist String.Empty.

- oder -

s enthält kein Datum und keine Uhrzeit, die format entsprechen.

ToDateTime(String, String[])

Quelle:

XmlConvert.cs

Konvertiert den String in ein DateTime-Äquivalent.

public:
 static DateTime ToDateTime(System::String ^ s, cli::array <System::String ^> ^ formats);

public static DateTime ToDateTime (string s, string[] formats);

static member ToDateTime : string * string[] -> DateTime

Public Shared Function ToDateTime (s As String, formats As String()) As DateTime

Parameter

s

String

Die zu konvertierende Zeichenfolge.

formats

String[]

Ein Array, das die Formatstrukturen enthält, die auf das konvertierte DateTime angewendet werden sollen. Zu den gültigen Format zählt „yyyy-MM-ddTHH:mm:sszzzzzz“ und dessen Teilmengen.

Gibt zurück

DateTime

Ein DateTime-Äquivalent der Zeichenfolge.

Ausnahmen

ArgumentNullException

s ist null.

FormatException

s oder ein Element von formats ist String.Empty.

- oder -

s enthält kein Datum und keine Uhrzeit, die einem der Elemente von formats entsprechen.

Hinweise

Mit dieser Methode können mehrere Formate für die Zeichenfolge überprüft werden.

ToDateTime(String, XmlDateTimeSerializationMode)

Quelle:

XmlConvert.cs

Konvertiert die String-Struktur mithilfe von XmlDateTimeSerializationMode in eine DateTime.

public:
 static DateTime ToDateTime(System::String ^ s, System::Xml::XmlDateTimeSerializationMode dateTimeOption);

public static DateTime ToDateTime (string s, System.Xml.XmlDateTimeSerializationMode dateTimeOption);

static member ToDateTime : string * System.Xml.XmlDateTimeSerializationMode -> DateTime

Public Shared Function ToDateTime (s As String, dateTimeOption As XmlDateTimeSerializationMode) As DateTime

Parameter

s

String

Der zu konvertierende String-Wert.

dateTimeOption

XmlDateTimeSerializationMode

Einer der Enumerationswerte, die angeben, ob das Datum in die Ortszeit konvertiert oder als UTC-Zeit (Coordinated Universal Time) beibehalten werden soll, falls es sich um ein UTC-Datum handelt.

Gibt zurück

DateTime

Ein DateTime-Äquivalent von String.

Ausnahmen

NullReferenceException

s ist null.

ArgumentNullException

dateTimeOption ist null.

FormatException

s ist eine leere Zeichenfolge oder weist kein gültiges Format auf.