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 van .NET standaard- of aangepaste datum- en tijdnotatietekenreeksen die de toegestane notaties van s.

Retouren

DateTimeOffset

Het DateTimeOffset equivalent van de opgegeven tekenreeks.

Uitzonderingen

FormatException

Een element formats is ongeldig of s komt niet exact overeen met een element onder formats de invariante cultuurregels, met uitzondering van voorloop- of volgspaties.

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

Deze overbelasting komt overeen met bellen DateTimeOffset.ParseExact(String, String[], IFormatProvider, DateTimeStyles) met DateTimeFormatInfo.InvariantInfo en de AllowLeadingWhite vlaggen AllowTrailingWhite . Voorloop- en volgspaties worden genegeerd, maar s moeten anders exact overeenkomen met een van de tekenreeksen in formats. De formats parameter maakt gebruik van .NET standaard tekenreeksen voor datum- en tijdnotatie of aangepaste datum- en tijdnotatietekenreeksen, niet voor datum/tijd-patronen voor XML-schema.

In een tekenreeks met aangepaste notatie vereisen de z, zzen zzz aanduidingen een ondertekende numerieke UTC-offset. Deze komen niet overeen met de XML UTC-ontwerpator Z. Gebruik de K aangepaste notatieaanduiding wanneer s deze kan bevatten Z.

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

Een .NET standaard- of aangepaste tekenreeks voor datum- en tijdnotatie waarmee de vereiste notatie wordt sopgegeven.

Retouren

DateTimeOffset

Het DateTimeOffset equivalent van de opgegeven tekenreeks.

Uitzonderingen

ArgumentNullException

s is null.

FormatException

format is ongeldig of s komt niet exact overeen format onder de regels voor invariante cultuur, met uitzondering van voorloop- of volgspaties.

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

Deze overbelasting komt overeen met bellen DateTimeOffset.ParseExact(String, String, IFormatProvider, DateTimeStyles) met DateTimeFormatInfo.InvariantInfo en de AllowLeadingWhite vlaggen AllowTrailingWhite . Voorloop- en volgspaties worden genegeerd, maar s moeten anders exact overeenkomen format. De format parameter maakt gebruik van .NET standaard tekenreeksen voor datum- en tijdnotatie of aangepaste datum- en tijdnotatietekenreeksen, niet voor datum/tijd-patronen voor XML-schema.

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?