XmlConvert.ToDateTime Метод

Определение

Пространство имен:

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Преобразует String в эквивалент DateTime.

Перегрузки

ToDateTime(String)	Устаревшие.. Преобразует String в эквивалент DateTime.
ToDateTime(String, String)	Преобразует String в эквивалент DateTime.
ToDateTime(String, String[])	Преобразует String в эквивалент DateTime.
ToDateTime(String, XmlDateTimeSerializationMode)	Преобразует объект String в объект DateTime с помощью заданного значения XmlDateTimeSerializationMode.

ToDateTime(String)

Исходный код:

XmlConvert.cs

Внимание!

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

Преобразует String в эквивалент 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

Параметры

s

String

Преобразуемая строка.

Возвращаемое значение

DateTime

Эквивалент строки DateTime.

Атрибуты

ObsoleteAttribute

Исключения

ArgumentNullException

s имеет значение null.

FormatException

Параметр s является пустой строкой или его формат неправилен.

Примеры

В следующем примере для чтения строго типизированных данных используется ToDouble и ToDateTime .

#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

В этом примере в качестве входных данных используется файл orderData.xml.

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

Комментарии

Примечание

Метод XmlConvert.ToDateTime(String) устарел в версии 2.0 платформа .NET Framework и заменен методом XmlConvert.ToDateTime(String, XmlDateTimeSerializationMode) .

ToDateTime(String, String)

Исходный код:

XmlConvert.cs

Преобразует String в эквивалент 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

Параметры

s

String

Преобразуемая строка.

format

String

Структура формата, которая применяется к преобразованному значению DateTime. Допустимы форматы типа "yyyy-MM-ddTHH:mm:sszzzzzz" и его подмножества. Строка проверяется по этому формату.

Возвращаемое значение

DateTime

Эквивалент строки DateTime.

Исключения

ArgumentNullException

s имеет значение null.

FormatException

Значение параметра s или format — String.Empty.

-или-

Параметр s не содержит дату и время, соответствующие параметру format.

ToDateTime(String, String[])

Исходный код:

XmlConvert.cs

Преобразует String в эквивалент 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

Параметры

s

String

Преобразуемая строка.

formats

String[]

Массив, содержащий структуры формата, которые применяются к преобразованному значению DateTime. Допустимы форматы типа "yyyy-MM-ddTHH:mm:sszzzzzz" и его подмножества.

Возвращаемое значение

DateTime

Эквивалент строки DateTime.

Исключения

ArgumentNullException

s имеет значение null.

FormatException

Значение параметра s или элемента параметра formats — String.Empty.

-или-

Параметр s не содержит дату и время, соответствующие какому-либо элементу параметра formats.

Комментарии

Этот метод позволяет проверять строку в нескольких форматах.

ToDateTime(String, XmlDateTimeSerializationMode)

Исходный код:

XmlConvert.cs

Преобразует объект String в объект DateTime с помощью заданного значения XmlDateTimeSerializationMode.

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

Параметры

s

String

Преобразуемое значение String.

dateTimeOption

XmlDateTimeSerializationMode

Одно из значений перечисления, указывающее, следует ли преобразовывать данные в локальное время или сохранять их во времени в формате UTC, если дата в формате UTC.

Возвращаемое значение

DateTime

Эквивалент DateTime для значения String.

Исключения

NullReferenceException

s имеет значение null.

ArgumentNullException

dateTimeOption имеет значение null.

FormatException

Параметр s является пустой строкой или его формат недопустим.