TimeZoneInfo.ClearCachedData 方法

定义

清除已缓存的时区数据。

public:
 static void ClearCachedData();
public static void ClearCachedData ();
static member ClearCachedData : unit -> unit
Public Shared Sub ClearCachedData ()

注解

缓存时区数据包括本地时区和协调世界时 (UTC) 区域的数据。

可以调用 ClearCachedData 此方法来减少专用于应用程序的时区信息的缓存的内存,或反映本地系统的时区已更改的事实。

不建议存储对本地和 UTC 时区的引用。 调用ClearCachedData该方法后,这些对象变量将是不再引用TimeZoneInfo.LocalTimeZoneInfo.Utc已定义的TimeZoneInfo对象。 例如,在以下代码中,对方法的第二次调用 TimeZoneInfo.ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) 会引发一个 ArgumentException ,因为 local 变量不再被视为等于 TimeZoneInfo.Local

TimeZoneInfo cst = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time");
TimeZoneInfo local = TimeZoneInfo.Local;
Console.WriteLine(TimeZoneInfo.ConvertTime(DateTime.Now, local, cst));

TimeZoneInfo.ClearCachedData();
try
{
   Console.WriteLine(TimeZoneInfo.ConvertTime(DateTime.Now, local, cst));
}
catch (ArgumentException e)
{
   Console.WriteLine(e.GetType().Name + "\n   " + e.Message);
}
open System

let cst = TimeZoneInfo.FindSystemTimeZoneById "Central Standard Time"
let local = TimeZoneInfo.Local
printfn $"{TimeZoneInfo.ConvertTime(DateTime.Now, local, cst)}"

TimeZoneInfo.ClearCachedData()
try
   printfn $"{TimeZoneInfo.ConvertTime(DateTime.Now, local, cst)}"
with :? ArgumentException as e ->
   printfn $"{e.GetType().Name}\n   {e.Message}"
Dim cst As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time")
Dim local As TimeZoneInfo = TimeZoneInfo.Local
Console.WriteLine(TimeZoneInfo.ConvertTime(Date.Now, local, cst))

TimeZoneInfo.ClearCachedData()
Try
   Console.WriteLine(TimeZoneInfo.ConvertTime(Date.Now, local, cst))
Catch e As ArgumentException
   Console.WriteLine(e.GetType().Name & vbCrLf & "   " & e.Message)
End Try

适用于