XmlConvert.ToDateTime Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Convertit la chaîne String en un équivalent DateTime.

Surcharges

ToDateTime(String)	Obsolète. Convertit la chaîne String en un équivalent DateTime.
ToDateTime(String, String)	Convertit la chaîne String en un équivalent DateTime.
ToDateTime(String, String[])	Convertit la chaîne String en un équivalent DateTime.
ToDateTime(String, XmlDateTimeSerializationMode)	Convertit l'élément String en une chaîne DateTime en utilisant le mode XmlDateTimeSerializationMode spécifié.

ToDateTime(String)

Source:

XmlConvert.cs

Attention

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

Convertit la chaîne String en un équivalent DateTime.

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

Paramètres

s

String

Chaîne à convertir.

Retours

DateTime

Équivalent DateTime de la chaîne.

Attributs

ObsoleteAttribute

Exceptions

ArgumentNullException

s a la valeur null.

FormatException

s est une chaîne vide et n'est pas dans le format approprié.

Exemples

L’exemple suivant utilise ToDouble et ToDateTime pour lire des données fortement typées.

#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

L’exemple utilise le fichier , orderData.xmlcomme entrée.

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

Remarques

Notes

La XmlConvert.ToDateTime(String) méthode est obsolète dans la version 2.0 du .NET Framework et a été remplacée par la XmlConvert.ToDateTime(String, XmlDateTimeSerializationMode) méthode .

ToDateTime(String, String)

Source:

XmlConvert.cs

Convertit la chaîne String en un équivalent DateTime.

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

Paramètres

s

String

Chaîne à convertir.

format

String

Structure du format à appliquer à l'élément DateTime converti. Les formats valides sont "yyyy-MM-ddTHH:mm:sszzzzzz" et ses sous-ensembles. La chaîne est validée par rapport à ce format.

Retours

DateTime

Équivalent DateTime de la chaîne.

Exceptions

ArgumentNullException

s a la valeur null.

FormatException

s ou format est String.Empty

- ou -

s ne contient aucune date ou heure correspondant à format.

ToDateTime(String, String[])

Source:

XmlConvert.cs

Convertit la chaîne String en un équivalent DateTime.

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

Paramètres

s

String

Chaîne à convertir.

formats

String[]

Tableau contenant les structures du format à appliquer à l'élément DateTime converti. Les formats valides sont "yyyy-MM-ddTHH:mm:sszzzzzz" et ses sous-ensembles.

Retours

DateTime

Équivalent DateTime de la chaîne.

Exceptions

ArgumentNullException

s a la valeur null.

FormatException

s ou un élément de formats est String.Empty

- ou -

s ne contient aucune date ou heure correspondant à un élément de formats.

Remarques

Cette méthode permet de valider plusieurs formats pour la chaîne.

ToDateTime(String, XmlDateTimeSerializationMode)

Source:

XmlConvert.cs

Convertit l'élément String en une chaîne DateTime en utilisant le mode XmlDateTimeSerializationMode spécifié.

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

Paramètres

s

String

Valeur String à convertir.

dateTimeOption

XmlDateTimeSerializationMode

Une des valeurs d’énumération qui spécifient si la date doit être convertie en heure locale ou conservée en temps UTC, s’il s’agit d’une date UTC.

Retours

DateTime

Équivalent DateTime de l'élément String.

Exceptions

NullReferenceException

s a la valeur null.

ArgumentNullException

dateTimeOption a la valeur null.

FormatException

s est une chaîne vide ou n'est pas dans un format valide.