XmlConvert.ToDateTimeOffset Método

Definição

Espaço de Nomes:: System.Xml

Assemblagens:: System.Xml.dll, System.Xml.ReaderWriter.dll

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

Assemblagem:: System.Xml.ReaderWriter.dll

Assemblagem:: System.Xml.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Converte o fornecido String para um DateTimeOffset equivalente.

Sobrecargas

Nome	Descrição
ToDateTimeOffset(String, String[])	Converte o fornecido String para um DateTimeOffset equivalente.
ToDateTimeOffset(String, String)	Converte o fornecido String para um DateTimeOffset equivalente.
ToDateTimeOffset(String)	Converte o fornecido String para um DateTimeOffset equivalente.

ToDateTimeOffset(String, String[])

Origem:: XmlConvert.cs

Origem:: XmlConvert.cs

Origem:: XmlConvert.cs

Origem:: XmlConvert.cs

Origem:: XmlConvert.cs

Converte o fornecido String para um DateTimeOffset equivalente.

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

Parâmetros

s: String

A cadeia a converter.

formats: String[]

Um array de strings de formatos de data e hora padrão ou personalizados .NET que especificam os formatos permitidos de s.

Devoluções

DateTimeOffset

O equivalente DateTimeOffset à corda fornecida.

Exceções

FormatException

Um elemento de formats é inválido, ou s não corresponde exatamente a nenhum elemento de formats sob as regras de cultura invariante, exceto para o espaço branco inicial ou final.

Exemplos

O exemplo seguinte demonstra como ler uma string a partir de um ficheiro XML e usar o ToDateTimeOffset método para converter a string num DateTimeOffset tipo. A cadeia de entrada deve validar-se contra um dos formatos especificados antes de ser convertida.

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

O exemplo utiliza o ficheiro 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>

Observações

Esta sobrecarga é equivalente a chamar DateTimeOffset.ParseExact(String, String[], IFormatProvider, DateTimeStyles) com e as AllowLeadingWhite bandeiras e AllowTrailingWhite DateTimeFormatInfo.InvariantInfo . O espaço em branco inicial e posterior é ignorado, mas s de outra forma deve corresponder exatamente a uma das cadeias em formats. O formats parâmetro utiliza cadeias de formato padrão de data e hora .NET ou cadeias personalizadas de formato de data e hora, não padrões dataHora do XML Schema.

Numa cadeia de formatos personalizada, os z, zz, e zzz os especificadores requerem um deslocamento numérico UTC assinado. Eles não correspondem ao designador ZXML UTC. Use o K especificador de formato personalizado quando s pode conter Z.

Se o deslocamento especificado dentro da string de entrada causar um overflow na representação desserializada do DateTimeOffset, é lançado um FormatException.

Quando são especificados mais de sete dígitos para frações de segundo, o valor é arredondado. Por exemplo, 00000004 torna-se 0000000 e 00000005 torna-se 0000001.

Aplica-se a

ToDateTimeOffset(String, String)

Origem:: XmlConvert.cs

Origem:: XmlConvert.cs

Origem:: XmlConvert.cs

Origem:: XmlConvert.cs

Origem:: XmlConvert.cs

Converte o fornecido String para um DateTimeOffset equivalente.

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

Parâmetros

s: String

A cadeia a converter.

format: String

Uma cadeia de formato de data e hora padrão ou personalizada .NET que especifica o formato necessário de s.

Devoluções

DateTimeOffset

O equivalente DateTimeOffset à corda fornecida.

Exceções

ArgumentNullException

s é null.

FormatException

format é inválido, ou s não corresponde format exatamente segundo as regras de cultura invariante, exceto para o espaço branco inicial ou final.

Exemplos

O exemplo seguinte demonstra como ler uma string a partir de um ficheiro XML e usar o ToDateTimeOffset método para converter a string num DateTimeOffset tipo. A cadeia de entrada é validada em relação ao formato especificado antes de ser convertida.

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

O exemplo utiliza o ficheiro 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>

Observações

Esta sobrecarga é equivalente a chamar DateTimeOffset.ParseExact(String, String, IFormatProvider, DateTimeStyles) com e as AllowLeadingWhite bandeiras e AllowTrailingWhite DateTimeFormatInfo.InvariantInfo . O espaço em branco inicial e posterior é ignorado, mas s deve corresponder exatamente formata . O format parâmetro utiliza cadeias de formato padrão de data e hora .NET ou cadeias personalizadas de formato de data e hora, não padrões dataHora do XML Schema.

Se o deslocamento especificado dentro da string de entrada causar um overflow na representação desserializada do DateTimeOffset, é lançado um FormatException.

Quando são especificados mais de sete dígitos para frações de segundo, o valor é arredondado. Por exemplo, 00000004 torna-se 0000000 e 00000005 torna-se 0000001.

Aplica-se a

ToDateTimeOffset(String)

Origem:: XmlConvert.cs

Origem:: XmlConvert.cs

Origem:: XmlConvert.cs

Origem:: XmlConvert.cs

Origem:: XmlConvert.cs

Converte o fornecido String para um DateTimeOffset equivalente.

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

Parâmetros

s: String

A cadeia a converter. A cadeia deve conformar-se a um subconjunto da Recomendação do W3C para o tipo de dataHora XML. Para mais informações, consulte a secção dateTime da especificação XML Schema.

Devoluções

DateTimeOffset

O equivalente DateTimeOffset à corda fornecida.

Exceções

ArgumentNullException

s é null.

ArgumentOutOfRangeException

O argumento passado a este método está fora do intervalo dos valores permitidos. Para informações sobre valores permitidos, veja DateTimeOffset.

FormatException

O argumento passado a este método não se enquadra num subconjunto das Recomendações do W3C para o tipo dataHora XML. Para mais informações, consulte a secção dateTime da especificação XML Schema.

Exemplos

O exemplo seguinte demonstra como ler uma string a partir de um ficheiro XML e usar o ToDateTimeOffset método para converter a string num DateTimeOffset tipo.

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

O exemplo utiliza o ficheiro 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>

Observações

Quando são especificados mais de sete dígitos para frações de segundo, o valor é arredondado. Por exemplo, 00000004 torna-se 0000000 e 00000005 torna-se 0000001.

Aplica-se a

Comentários

Esta página foi útil?