XmlConvert.ToDateTime 方法

參考

定義

命名空間:: System.Xml

組件:: System.Xml.ReaderWriter.dll

組件:: System.Xml.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將 String 轉換成對等的 DateTime。

多載

ToDateTime(String)	已過時。已過時。將 String 轉換成對等的 DateTime。
ToDateTime(String, String)	將 String 轉換成對等的 DateTime。
ToDateTime(String, String[])	將 String 轉換成對等的 DateTime。
ToDateTime(String, XmlDateTimeSerializationMode)	使用指定的 XmlDateTimeSerializationMode，將 String 轉換為 DateTime。

ToDateTime(String)

警告

Use XmlConvert.ToDateTime() that takes in XmlDateTimeSerializationMode

警告

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

將 String 轉換成對等的 DateTime。

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

[System.Obsolete("Use XmlConvert.ToDateTime() that takes in XmlDateTimeSerializationMode")]
public static DateTime ToDateTime (string s);

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

public static DateTime ToDateTime (string s);

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

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

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)

將 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[])

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

使用指定的 XmlDateTimeSerializationMode，將 String 轉換為 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

參數

s: String

要進行轉換的 String 值。

dateTimeOption: XmlDateTimeSerializationMode

其中一個列舉值，可指定應將日期轉換為當地時間，或保留為國際標準時間 (UTC) (如果它是 UTC 日期)。

傳回

DateTime

String 的對等 DateTime。

例外狀況

NullReferenceException

s 為 null。

ArgumentNullException

dateTimeOption 為 null。

FormatException

s 是空字串或不是使用有效的格式。

適用於

共用方式為

XmlConvert.ToDateTime 方法

定義

多載

ToDateTime(String)

參數

傳回

例外狀況

範例

備註

適用於

ToDateTime(String, String)

參數

傳回

例外狀況

適用於

ToDateTime(String, String[])

參數

傳回

例外狀況

備註

適用於

ToDateTime(String, XmlDateTimeSerializationMode)

參數

傳回

例外狀況

適用於

其他資源