XmlConvert.ToDateTimeOffset Méthode

Définition

Espace de noms:: System.Xml

Assemblys:: System.Xml.dll, System.Xml.ReaderWriter.dll

Assemblys:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Convertit le fourni String en DateTimeOffset équivalent.

Surcharges

Nom	Description
ToDateTimeOffset(String, String[])	Convertit le fourni String en DateTimeOffset équivalent.
ToDateTimeOffset(String, String)	Convertit le fourni String en DateTimeOffset équivalent.
ToDateTimeOffset(String)	Convertit le fourni String en DateTimeOffset équivalent.

ToDateTimeOffset(String, String[])

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Convertit le fourni String en DateTimeOffset équivalent.

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

Paramètres

s: String

La chaîne à convertir.

formats: String[]

Tableau d'.NET chaînes de format de date et d’heure standard ou personnalisées qui spécifient les formats autorisés de s.

Retours

DateTimeOffset

Équivalent DateTimeOffset de la chaîne fournie.

Exceptions

FormatException

Un élément d’un formats élément n’est pas valide ou s ne correspond exactement à aucun élément des règles de culture invariantes, à l’exception de formats l’espace blanc de début ou de fin.

Exemples

L’exemple suivant montre comment lire une chaîne à partir d’un fichier XML et utiliser la ToDateTimeOffset méthode pour convertir la chaîne en type DateTimeOffset . La chaîne d’entrée doit être validée par rapport à l’un des formats spécifiés avant d’être convertie.

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

L’exemple utilise le fichier transactions.xml.

<?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>

Remarques

Cette surcharge équivaut à appeler DateTimeOffset.ParseExact(String, String[], IFormatProvider, DateTimeStyles) avec DateTimeFormatInfo.InvariantInfo et aux AllowLeadingWhite AllowTrailingWhite indicateurs. L’espace blanc de début et de fin est ignoré, mais s doit correspondre exactement à l’une des chaînes dans formats. Le formats paramètre utilise .NET chaînes de format de date et d’heure standard ou de chaînes de format de date et d’heure personnalisées, et non des modèles dateTime de schéma XML.

Dans une chaîne de format personnalisée, les zzzspécificateurs et zzz les spécificateurs nécessitent un décalage UTC numérique signé. Ils ne correspondent pas au dessinateur ZUTC XML. Utilisez le spécificateur de K format personnalisé quand s il peut contenir Z.

Si le décalage spécifié dans la chaîne d’entrée entraîne un dépassement de capacité dans la représentation désérialisée de DateTimeOffset, une exception FormatException est levée.

Lorsque plus de sept chiffres sont spécifiés pendant des fractions de secondes, la valeur est arrondie. Par exemple, 00000004 devient 00000000 et 00000005 devient 0000001.

S’applique à

ToDateTimeOffset(String, String)

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Convertit le fourni String en DateTimeOffset équivalent.

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

Paramètres

s: String

La chaîne à convertir.

format: String

Chaîne .NET de format de date et d’heure standard ou personnalisée qui spécifie le format requis de s.

Retours

DateTimeOffset

Équivalent DateTimeOffset de la chaîne fournie.

Exceptions

ArgumentNullException

s a la valeur null.

FormatException

format n’est pas valide ou s ne correspond format pas exactement aux règles de culture invariantes, à l’exception de l’espace blanc de début ou de fin.

Exemples

L’exemple suivant montre comment lire une chaîne à partir d’un fichier XML et utiliser la ToDateTimeOffset méthode pour convertir la chaîne en type DateTimeOffset . La chaîne d’entrée est validée par rapport au format spécifié avant d’être convertie.

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

L’exemple utilise le fichier transactions.xml.

<?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>

Remarques

Cette surcharge équivaut à appeler DateTimeOffset.ParseExact(String, String, IFormatProvider, DateTimeStyles) avec DateTimeFormatInfo.InvariantInfo et aux AllowLeadingWhite AllowTrailingWhite indicateurs. L’espace blanc de début et de fin est ignoré, mais s doit sinon correspondre formatexactement . Le format paramètre utilise .NET chaînes de format de date et d’heure standard ou de chaînes de format de date et d’heure personnalisées, et non des modèles dateTime de schéma XML.

Si le décalage spécifié dans la chaîne d’entrée entraîne un dépassement de capacité dans la représentation désérialisée de DateTimeOffset, une exception FormatException est levée.

Lorsque plus de sept chiffres sont spécifiés pendant des fractions de secondes, la valeur est arrondie. Par exemple, 00000004 devient 00000000 et 00000005 devient 0000001.

S’applique à

ToDateTimeOffset(String)

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Source:: XmlConvert.cs

Convertit le fourni String en DateTimeOffset équivalent.

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

Paramètres

s: String

La chaîne à convertir. La chaîne doit être conforme à un sous-ensemble de la recommandation W3C pour le type dateTime XML. Pour plus d’informations, consultez la section dateTime de la spécification du schéma XML.

Retours

DateTimeOffset

Équivalent DateTimeOffset de la chaîne fournie.

Exceptions

ArgumentNullException

s a la valeur null.

ArgumentOutOfRangeException

L’argument passé à cette méthode est en dehors de la plage de valeurs autorisées. Pour plus d’informations sur les valeurs autorisées, consultez DateTimeOffset.

FormatException

L’argument passé à cette méthode n’est pas conforme à un sous-ensemble des recommandations W3C pour le type dateTime XML. Pour plus d’informations, consultez la section dateTime de la spécification du schéma XML.

Exemples

L’exemple suivant montre comment lire une chaîne à partir d’un fichier XML et utiliser la ToDateTimeOffset méthode pour convertir la chaîne en type DateTimeOffset .

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

L’exemple utilise le fichier transactions.xml.

<?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>

Remarques

Lorsque plus de sept chiffres sont spécifiés pendant des fractions de secondes, la valeur est arrondie. Par exemple, 00000004 devient 00000000 et 00000005 devient 0000001.

S’applique à

Commentaires

Cette page a-t-elle été utile ?