dateTimeInvalidLocalFormat MDA

  • Makale

Not

Bu makale .NET Framework'e özgüdür. .NET 6 ve sonraki sürümleri de dahil olmak üzere daha yeni .NET uygulamaları için geçerli değildir.

dateTimeInvalidLocalFormat Evrensel Eşgüdümlü Saat (UTC) olarak depolanan bir DateTime örnek yalnızca yerel DateTime örnekler için kullanılması amaçlanan bir biçim kullanılarak biçimlendirildiğinde MDA etkinleştirilir. Bu MDA belirtilmeyen veya varsayılan DateTime örnekler için etkinleştirilmedi.

Belirti

Bir uygulama, yerel bir biçim kullanarak UTC DateTime örneğini el ile seri hale getirerek:

DateTime myDateTime = DateTime.UtcNow;
Serialize(myDateTime.ToString("yyyy-MM-dd'T'HH:mm:ss.fffffffzzz"));

Neden

Yöntemin DateTime.ToString 'z' biçimi yerel saat dilimi uzaklığını içerir; örneğin, Sidney saati için "+10:00". Bu nedenle, yalnızca değerinin DateTime yerel olması durumunda anlamlı bir sonuç üretir. Değer UTC saati ise, DateTime.ToString yerel saat dilimi uzaklığını içerir, ancak saat dilimi tanımlayıcısını görüntülemez veya ayarlamaz.

Çözüm

UTC örnekleri UTC DateTime olduğunu gösterecek şekilde biçimlendirilmelidir. UTC saatini belirtmek üzere 'Z' kullanmak üzere UTC saatleri için önerilen biçim:

DateTime myDateTime = DateTime.UtcNow;
Serialize(myDateTime.ToString("yyyy-MM-dd'T'HH:mm:ss.fffffffZ"));

Ayrıca, örneğin yerel, UTC veya belirtilmemiş olmasına bakılmaksızın doğru şekilde seri hale getiren özelliğin kullanımını Kind seri hale getiren bir DateTime "o" biçimi de vardır:

DateTime myDateTime = DateTime.UtcNow;
Serialize(myDateTime.ToString("o"));

Çalışma Zamanı üzerindeki etkisi

Bu MDA çalışma zamanını etkilemez.

Çıktı

Bu MDA etkinleştirmesinin bir sonucu olarak özel bir çıkış yoktur. Bununla birlikte, çağrı yığını MDA'yı etkinleştiren çağrının ToString konumunu belirlemek için kullanılabilir.

Yapılandırma

<mdaConfig>
  <assistants>
    <dateTimeInvalidLocalFormat />
  </assistants>
</mdaConfig>

Örnek

veya DataSet sınıfını kullanarak XmlConvert bir UTC DateTime değerini dolaylı olarak seri hale getiren bir uygulamayı aşağıdaki şekilde düşünün.

DateTime myDateTime = DateTime.UtcNow;
String serialized = XMLConvert.ToString(myDateTime);

XmlConvert ve DataSet serileştirmeleri, varsayılan olarak serileştirme için yerel biçimleri kullanır. UTC gibi diğer değer türlerini DateTime seri hale getirmek için ek seçenekler gereklidir.

Bu özel örnek için üzerinde çağrısına ToStringXmlConvertgeçinXmlDateTimeSerializationMode.RoundtripKind. Bu, verileri UTC saati olarak serileştirir.

kullanıyorsanız DataSet, nesnesinde DateTimeModeDataColumn özelliğini olarak Utcayarlayın.

DateTime myDateTime = DateTime.UtcNow;
String serialized = XmlConvert.ToString(myDateTime,
    XmlDateTimeSerializationMode.RoundtripKind);

Ayrıca bkz.