XmlConvert.ToDateTimeOffset Methode

Definitie

Naamruimte:: System.Xml

Assembly's:: System.Xml.dll, System.Xml.ReaderWriter.dll

Assembly's:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Converteert de opgegeven String waarde naar een DateTimeOffset equivalent.

Overloads

Name	Description
ToDateTimeOffset(String, String[])	Converteert de opgegeven String waarde naar een DateTimeOffset equivalent.
ToDateTimeOffset(String, String)	Converteert de opgegeven String waarde naar een DateTimeOffset equivalent.
ToDateTimeOffset(String)	Converteert de opgegeven String waarde naar een DateTimeOffset equivalent.

ToDateTimeOffset(String, String[])

Bron:: XmlConvert.cs

Bron:: XmlConvert.cs

Bron:: XmlConvert.cs

Bron:: XmlConvert.cs

Bron:: XmlConvert.cs

Converteert de opgegeven String waarde naar een DateTimeOffset equivalent.

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

public static DateTimeOffset ToDateTimeOffset(string s, string[] formats);

static member ToDateTimeOffset : string * string[] -> DateTimeOffset

Public Shared Function ToDateTimeOffset (s As String, formats As String()) As DateTimeOffset

Parameters

s: String

De tekenreeks die moet worden geconverteerd.

formats: String[]

Een matrix met indelingen waaruit s kan worden geconverteerd. Elke indeling in formats kan elke subset van de W3C-aanbeveling zijn voor het type XML-datum/tijd. (Zie de sectie dateTime van de specificatie van het XML-schema voor meer informatie.) De tekenreeks s wordt gevalideerd op basis van een van deze indelingen.

Retouren

DateTimeOffset

Het DateTimeOffset equivalent van de opgegeven tekenreeks.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een tekenreeks leest uit een XML-bestand en hoe u de ToDateTimeOffset methode gebruikt om de tekenreeks te converteren naar een DateTimeOffset type. De invoertekenreeks moet worden gevalideerd op basis van een van de opgegeven indelingen voordat deze wordt geconverteerd.

using System;
using System.Xml;

class Example
{
    static void Main()
    {
        // Create an XmlReader, read to the "time" element, and read contents as type string
        XmlReader reader = XmlReader.Create("transactions.xml");
        reader.ReadToFollowing("time");
        string time = reader.ReadElementContentAsString();

        // Specify formats against which time will be validated before conversion to DateTimeOffset
        // If time does not match one of the specified formats, a FormatException will be thrown.
        // Each specified format must be a subset of the W3C Recommendation for the XML dateTime type
        string[] formats = {"yyyy-MM-ddTHH:mm:sszzzzzzz", "yyyy-MM-ddTHH:mm:ss", "yyyy-MM-dd"};
        try
        {
            // Read the element contents as a string and covert to DateTimeOffset type
            DateTimeOffset transaction_time = XmlConvert.ToDateTimeOffset(time, formats);
            Console.WriteLine(transaction_time);
        }
        catch (Exception e)
        {
            Console.WriteLine(e);
        }
    }
}

Imports System.Xml

Module Module1
    Sub Main()
        ' Create an XmlReader, read to the "time" element, and read contents as type string
        Dim reader As XmlReader = XmlReader.Create("transactions.xml")
        reader.ReadToFollowing("time")
        Dim time As String = reader.ReadElementContentAsString()

        ' Specify formats against which time will be validated before conversion to DateTimeOffset
        ' If time does not match one of the specified formats, a FormatException will be thrown.
        ' Each specified format must be a subset of the W3C Recommendation for the XML dateTime type
        Dim formats As String() = {"yyyy-MM-ddTHH:mm:sszzzzzzz", "yyyy-MM-ddTHH:mm:ss", "yyyy-MM-dd"}
        Try
            ' Read the element contents as a string and covert to DateTimeOffset type
            Dim transaction_time As DateTimeOffset = XmlConvert.ToDateTimeOffset(time, formats)
            Console.WriteLine(transaction_time)
        Catch e As Exception
            Console.WriteLine(e)
        End Try
    End Sub
End Module

In het voorbeeld wordt het transactions.xml-bestand gebruikt.

<?xml version="1.0"?>
<transactions>
   <transaction>
      <id>123456789</id>
      <amount>1.00</amount>
      <currency>USD</currency>
      <time>2007-08-03T22:05:13-07:00</time>
   </transaction>
</transactions>

Opmerkingen

Als de verschuiving die is opgegeven in de invoertekenreeks een overloop veroorzaakt in de gedeserialiseerde weergave van de DateTimeOffset, wordt er een FormatException gegenereerd.

Wanneer er meer dan zeven cijfers worden opgegeven voor fractionele seconden, wordt de waarde afgerond. 00000004 wordt bijvoorbeeld 00000000 en 00000005 0000001.

Van toepassing op

ToDateTimeOffset(String, String)

Bron:: XmlConvert.cs

Bron:: XmlConvert.cs

Bron:: XmlConvert.cs

Bron:: XmlConvert.cs

Bron:: XmlConvert.cs

Converteert de opgegeven String waarde naar een DateTimeOffset equivalent.

public:
 static DateTimeOffset ToDateTimeOffset(System::String ^ s, System::String ^ format);

public static DateTimeOffset ToDateTimeOffset(string s, string format);

static member ToDateTimeOffset : string * string -> DateTimeOffset

Public Shared Function ToDateTimeOffset (s As String, format As String) As DateTimeOffset

Parameters

s: String

De tekenreeks die moet worden geconverteerd.

format: String

De indeling waaruit s wordt geconverteerd. De indelingsparameter kan elke subset van de W3C-aanbeveling zijn voor het type XML-datum/tijd. (Zie de sectie dateTime van de specificatie van het XML-schema voor meer informatie.) De tekenreeks s wordt gevalideerd op basis van deze indeling.

Retouren

DateTimeOffset

Het DateTimeOffset equivalent van de opgegeven tekenreeks.

Uitzonderingen

ArgumentNullException

s is null.

FormatException

s of format een lege tekenreeks is of niet de opgegeven indeling heeft.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een tekenreeks leest uit een XML-bestand en hoe u de ToDateTimeOffset methode gebruikt om de tekenreeks te converteren naar een DateTimeOffset type. De invoertekenreeks wordt gevalideerd op basis van de opgegeven indeling voordat deze wordt geconverteerd.

using System;
using System.Xml;

class Example
{
    static void Main()
    {
        // Create an XmlReader, read to the "time" element, and read contents as type string
        XmlReader reader = XmlReader.Create("transactions.xml");
        reader.ReadToFollowing("time");
        string time = reader.ReadElementContentAsString();

        // Specify a format against which time will be validated before conversion to DateTimeOffset
        // If time does not match the format, a FormatException will be thrown.
        // The specified format must be a subset of the W3C Recommendation for the XML dateTime type
        string format = "yyyy-MM-ddTHH:mm:sszzzzzzz";
        try
        {
            // Read the element contents as a string and covert to DateTimeOffset type
            DateTimeOffset transaction_time = XmlConvert.ToDateTimeOffset(time, format);
            Console.WriteLine(transaction_time);
        }
        catch(Exception e)
        {
            Console.WriteLine(e);
        }
    }
}

Imports System.Xml

Module Module1      
    Sub Main()
        ' Create an XmlReader, read to the "time" element, and read contents as type string
        Dim reader As XmlReader = XmlReader.Create("transactions.xml")
        reader.ReadToFollowing("time")
        Dim time As String = reader.ReadElementContentAsString()

        ' Specify a format against which time will be validated before conversion to DateTimeOffset
        ' If time does not match the format, a FormatException will be thrown.
        ' The specified format must be a subset of the W3C Recommendation for the XML dateTime type
        Dim format As String = "yyyy-MM-ddTHH:mm:sszzzzzzz"
        Try
            ' Read the element contents as a string and covert to DateTimeOffset type
            Dim transaction_time As DateTimeOffset = XmlConvert.ToDateTimeOffset(time, format)
            Console.WriteLine(transaction_time)
        Catch e As Exception
            Console.WriteLine(e)
        End Try
    End Sub
End Module

In het voorbeeld wordt het transactions.xml-bestand gebruikt.

<?xml version="1.0"?>
<transactions>
   <transaction>
      <id>123456789</id>
      <amount>1.00</amount>
      <currency>USD</currency>
      <time>2007-08-03T22:05:13-07:00</time>
   </transaction>
</transactions>

Opmerkingen

Als de verschuiving die is opgegeven in de invoertekenreeks een overloop veroorzaakt in de gedeserialiseerde weergave van de DateTimeOffset, wordt er een FormatException gegenereerd.

Wanneer er meer dan zeven cijfers worden opgegeven voor fractionele seconden, wordt de waarde afgerond. 00000004 wordt bijvoorbeeld 00000000 en 00000005 0000001.

Van toepassing op

ToDateTimeOffset(String)

Bron:: XmlConvert.cs

Bron:: XmlConvert.cs

Bron:: XmlConvert.cs

Bron:: XmlConvert.cs

Bron:: XmlConvert.cs

Converteert de opgegeven String waarde naar een DateTimeOffset equivalent.

public:
 static DateTimeOffset ToDateTimeOffset(System::String ^ s);

public static DateTimeOffset ToDateTimeOffset(string s);

static member ToDateTimeOffset : string -> DateTimeOffset

Public Shared Function ToDateTimeOffset (s As String) As DateTimeOffset

Parameters

s: String

De tekenreeks die moet worden geconverteerd. De tekenreeks moet voldoen aan een subset van de W3C-aanbeveling voor het type XML-datum/tijd. Zie de sectie DateTime van de XML-schemaspecificatie voor meer informatie.

Retouren

DateTimeOffset

Het DateTimeOffset equivalent van de opgegeven tekenreeks.

Uitzonderingen

ArgumentNullException

s is null.

ArgumentOutOfRangeException

Het argument dat aan deze methode wordt doorgegeven, valt buiten het bereik van toegestane waarden. Zie voor meer informatie over toegestane waarden DateTimeOffset.

FormatException

Het argument dat aan deze methode wordt doorgegeven, voldoet niet aan een subset van de W3C-aanbevelingen voor het TYPE XML-datum/tijd. Zie de sectie DateTime van de XML-schemaspecificatie voor meer informatie.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een tekenreeks leest uit een XML-bestand en hoe u de ToDateTimeOffset methode gebruikt om de tekenreeks te converteren naar een DateTimeOffset type.

using System;
using System.Xml;

class Example
{
    static void Main()
    {
        // Create an XmlReader, read to the "time" element, and read contents as type string
        XmlReader reader = XmlReader.Create("transactions.xml");
        reader.ReadToFollowing("time");
        string time = reader.ReadElementContentAsString();

        // Read the element contents as a string and covert to DateTimeOffset type
        // The format of time must be a subset of the W3C Recommendation for the XML dateTime type
        DateTimeOffset transaction_time = XmlConvert.ToDateTimeOffset(time);
        Console.WriteLine(transaction_time);
    }
}

Imports System.Xml

Module Module1
    Sub Main()
        ' Create an XmlReader, read to the "time" element, and read contents as type string
        Dim reader As XmlReader = XmlReader.Create("transactions.xml")
        reader.ReadToFollowing("time")
        Dim time As String = reader.ReadElementContentAsString()

        ' Read the element contents as a string and covert to DateTimeOffset type
    ' The format of time must be a subset of the W3C Recommendation for the XML dateTime type
        Dim transaction_time As DateTimeOffset = XmlConvert.ToDateTimeOffset(time)
        Console.WriteLine(transaction_time)
    End Sub
End Module

In het voorbeeld wordt het transactions.xml-bestand gebruikt.

<?xml version="1.0"?>
<transactions>
   <transaction>
      <id>123456789</id>
      <amount>1.00</amount>
      <currency>USD</currency>
      <time>2007-08-03T22:05:13-07:00</time>
   </transaction>
</transactions>

Opmerkingen

Wanneer er meer dan zeven cijfers worden opgegeven voor fractionele seconden, wordt de waarde afgerond. 00000004 wordt bijvoorbeeld 00000000 en 00000005 0000001.

Van toepassing op

Feedback

Is deze pagina nuttig?