From: 011netservice@gmail.com
Date: 2023-05-29
Subject: Diary-Home.txt
File: work\Diary-Home.txt



歡迎來信交流, 訂購軟體需求.
以下 #### 標記段落, **** 標記常用(流程、設定、備忘)

#### System.Runtime.Caching
20230529, Honda, .NET Standard 2.0 以上必須自行下載 NuGet Packages:  System.Runtime.Caching/MemoryCache, 可再搭配 Microsoft.Extensions.Caching.Memory/IMemoryCache 使用看看.
Commonly Used Types:
System.Runtime.Caching.CacheEntryChangeMonitor
System.Runtime.Caching.CacheEntryRemovedArguments
System.Runtime.Caching.CacheEntryUpdateArguments
System.Runtime.Caching.CacheItem
System.Runtime.Caching.CacheItemPolicy
System.Runtime.Caching.ChangeMonitor
System.Runtime.Caching.FileChangeMonitor
System.Runtime.Caching.HostFileChangeMonitor
System.Runtime.Caching.MemoryCache
System.Runtime.Caching.ObjectCache

Cache in-memory in ASP.NET Core
ref: https://learn.microsoft.com/en-us/aspnet/core/performance/caching/memory?view=aspnetcore-7.0
System.Runtime.Caching/MemoryCache (NuGet package) can be used with:

.NET Standard 2.0 or later.
Any .NET implementation that targets .NET Standard 2.0 or later. For example, ASP.NET Core 3.1 or later.
.NET Framework 4.5 or later.
Microsoft.Extensions.Caching.Memory/IMemoryCache (described in this article) is recommended over System.Runtime.Caching/MemoryCache because it's better integrated into ASP.NET Core. For example, IMemoryCache works natively with ASP.NET Core dependency injection.

Use System.Runtime.Caching/MemoryCache as a compatibility bridge when porting code from ASP.NET 4.x to ASP.NET Core.


#### 舊文件, 確認以後移到上面.
----------
20190706


C# Cache緩存讀取設置 - 掃文資訊
https://hk.saowen.com/a/e07369b424958f1b13544302463944fa072a578ca8ecc50a6f3a10bb66e3a330

The Will Will Web | ASP.NET 如何將目前的 Cache 物件全部清空
https://blog.miniasp.com/post/2008/04/11/How-to-clear-all-cache-items-in-ASPNET.aspx

----------
20190603

private void btnGet_Click(object sender, EventArgs e)  
{  
    ObjectCache cache = MemoryCache.Default;  
    string fileContents = cache["filecontents"] as string;  

    if (fileContents == null)  
    {  
        CacheItemPolicy policy = new CacheItemPolicy();  

        List<string> filePaths = new List<string>();  
        filePaths.Add("c:\\cache\\example.txt");  

        policy.ChangeMonitors.Add(new   
        HostFileChangeMonitor(filePaths));  

        // Fetch the file contents.  
        fileContents = File.ReadAllText("c:\\cache\\example.txt");  

        cache.Set("filecontents", fileContents, policy);  
    }  

    Label1.Text = fileContents;  
}

The MemoryCache class is a concrete implementation of the abstract ObjectCache class. 
 Note
The MemoryCache class is similar to the ASP.NET Cache class. The MemoryCache class has many properties and methods for accessing the cache that will be familiar to you if you have used the ASP.NET Cache class. The main differences between the Cache and MemoryCache classes are that the MemoryCache class has been changed to make it usable by .NET Framework applications that are not ASP.NET applications. For example, the MemoryCache class has no dependencies on the System.Web assembly. Another difference is that you can create multiple instances of the MemoryCache class for use in the same application and in the same AppDomain instance. 

The MemoryCache class does not allow null as a value in the cache. Any attempt to add or change a cache entry with a value of null will fail. 
The MemoryCache type does not implement cache regions. Therefore, when you call MemoryCache methods that implement base methods that contain a parameter for regions, do not pass a value for the parameter. The methods that use the region parameter all supply a default null value. For example, the MemoryCache.AddOrGetExisting method overload has a regionName parameter whose default value is null.





ref:
MemoryCache Class
https://docs.microsoft.com/en-us/dotnet/api/system.runtime.caching.memorycache?redirectedfrom=MSDN&view=netframework-4.8

ASP.NET 4 快取 API 有兩種: Cache 與 ObjectCache
https://blog.miniasp.com/post/2010/05/01/ASPNET-4-Cache-API-and-ObjectCache

https://blog.yowko.com/net-framework-memorycache-1/ Part 1 極簡做法
https://blog.yowko.com/net-framework-memorycache-2/ Part 2 使用 lock 避免 ddos db
https://blog.yowko.com/net-framework-memorycache-3/ Part 3 隱藏的效能瓶頸
https://blog.yowko.com/net-framework-memorycache-4/ Part 4 使用泛型來簡化


ASP.NET 從最早期的版本就實做了一套好用的快取機制 (System.Web.Caching.Cache)，一直以來任何非 ASP.NET 的應用程式 (例如 WinForm, WPF, Console, WinService, …) 若要使用快取機制都必須將 System.Web.dll 參考進專案才能使用，但從 .NET 4.0 開始出現了另一個擴充性更強的快取機制，稱為 Object Caching (物件快取) 機制，未來這兩套快取機制將各司其職、相輔相成。
從 .NET 4.0 開始，.Net Framework 參考了 ASP.NET 內建的快取機制，並明確實做了另一個獨立存在的快取組件：System.Runtime.Caching.dll，此組件非常的小，我用 NDepend 工具分析了一下此組件，總共 IL 指令集僅有 9,844 個而已，而 System.Web.dll 的 IL 指令集總共有 496,395 個之多，就算只計算 System.Web.Caching 命名空間的 IL 也有 14,760 個，還是比這次新增的 System.Runtime.Caching.dll 來的大。
備註：原本的 System.Web.Caching.Cache 類別依然存在，功能與之前一樣，還是可以正常使用。
這個新的 System.Runtime.Caching.dll 組件在 System.Runtime.Caching 命名空間 包含了一組全新的 Cache API，而此 API 包含了兩組核心類別：
透過一組抽象類別可讓你自行實做任意物件快取機制，例如: 實做分散式快取機制。
透過此抽象類別實做的記憶體快取機制類別: System.Runtime.Caching.MemoryCache 類別。
如果你曾經用過 ASP.NET Cache 物件，因為兩者的相似性非常高，所以要上手使用 MemoryCache 那可是非常容易，以下是 MemoryCache 的使用範例 ( 以 Windows Form 做範例 )：
private void btnGet_Click(object sender, EventArgs e) 
{ 
  //Obtain a reference to the default MemoryCache instance. 
  //Note that you can create multiple MemoryCache(s) inside 
  //of a single application. 
  ObjectCache cache = MemoryCache.Default; 
  
  //In this example the cache is storing the contents of a file string 
  fileContents = cache["filecontents"] as string;
  
  //If the file contents are not currently in the cache, then 
  //the contents are read from disk and placed in the cache. 
  if (fileContents == null) 
  {
    //A CacheItemPolicy object holds all the pieces of cache 
    //dependency and cache expiration metadata related to a single 
    //cache entry. 
    CacheItemPolicy policy = new CacheItemPolicy(); 
    
    //Build up the information necessary to create a file dependency. 
    //In this case we just need the file path of the file on disk. 
    List filePaths = new List(); 
    filePaths.Add("c:\\data.txt"); 
    
    //In the new cache API, dependencies are called "change monitors". 
    //For this example we want the cache entry to be automatically expired 
    //if the contents on disk change. A HostFileChangeMonitor provides 
    //this functionality. 
    policy.ChangeMonitors.Add(new HostFileChangeMonitor(filePaths)); 
    
    //Fetch the file's contents 
    fileContents = File.ReadAllText("c:\\data.txt"); 
    
    //And then store the file's contents in the cache 
    cache.Set("filecontents", fileContents, policy); 
    
  } 
  MessageBox.Show(fileContents); 
}
System.Web.Caching 中內建的 Cache 與 System.Runtime.Caching 的 MemoryCache 有幾點需注意：
System.Runtime.Caching.dll 組件下的 MemoryCache 類別與 System.Web.dll 組件下的 Cache 類別完全沒有相依性，兩者是完全獨立的組件，任何非 ASP.NET 應用程式都不應該載入 System.Web.dll 組件來實做快取。
ASP.NET 的 Cache 與 MemoryCache 雖然都是記憶體快取(In-memory cache)，但在 ASP.NET 中只能使用一份 Cache 物件，而在 MemoryCache 可在 AppDomain 中建立多份快取物件。
像我們之前在開發大型網站時，由於 ASP.NET 快取資料只能儲存在記憶體中，這對於大型網站來說非常不實用，甚至於”不能用”，有了 ObjectCache 機制這才出現了一絲生機，這時你就可以在 ASP.NET 中透過 ObjectCache 機制載入自訂的快取機制 (例如: Velocity, Memcached, ScaleOut, … ) 來加強網站的延展性 (Scalability)，相信此功能對擁有大量快取需求的開發人員來說絕對是一大福音。



----------
20190118

ref:

http://zerotiem22.blogspot.com/2018/03/c-cache_27.html

C# Cache 用法介紹及實作測試 
C# Cache 介紹 及實作測試

Cache練習 Source Code(GitHub)： https://github.com/ZeroTiem/CacheExercise 

Cache的選擇
.NET快取差異對照表

Cache
  實作 Web 應用程式的快取。 這個類別無法被繼承。
  命名空間:   System.Web.Caching
  組件:  System.Web (於 System.Web.dll) 
  繼承階層 System.Object System.Web.Caching.Cache
  .NET WEB應用程式
  .NET Framework 3.5 或之前版本為目標
  只能存在記憶體中可/集中式
  版本比較舊只能支援在WEB 應用程式，因為只能存在本機的記憶體中，所以無法支援分散式架構。


MemoryCache	  
  表示可實作記憶體內部快取的類型。
  命名空間:   System.Runtime.Caching
  組件:       System.Runtime.Caching (於 System.Runtime.Caching.dll)
  繼承階層 System.Object
           System.Runtime.Caching.ObjectCache
           System.Runtime.Caching.MemoryCache
  任何.NET 應用程式
  .NET Framework 4.0 或之後版本為目標
  能存在記憶體中以外的地方/分散式
  新版的快取機制可以支援在所有 .NET 程式中，需要自制一些快取機制可以用他來寫，因為可以儲存於本機外的記憶體所以也支援分散式架構。
		 
ObjectCache
  表示物件快取，並提供基底方法和屬性存取物件快取。
  命名空間:   System.Runtime.Caching
  組件:  System.Runtime.Caching (於 System.Runtime.Caching.dll)
  繼承階層 System.Object
           System.Runtime.Caching.ObjectCache
           System.Runtime.Caching.MemoryCache
  任何.NET 應用程式
  .NET Framework 4.0 或之後版本為目標
  能存在記憶體中以外的地方/分散式
  提供標準的介面來統一快取機制的操做，所以他只是抽象的介面底層還是實作 MemoryCache，也因為如此 MemoryCache 有的特性他也有，也提供了很多方法可以使用 。(也因為底層實作是 MemoryCache 所以應該也會支援分散架構)。


參考資訊：
 https://msdn.microsoft.com/zh-tw/library/system.web.caching.cache(v=vs.110).aspx
https://msdn.microsoft.com/zh-tw/library/system.runtime.caching.memorycache(v=vs.110).aspx
https://msdn.microsoft.com/zh-tw/library/system.runtime.caching.objectcache(v=vs.110).aspx



ObjectCache 說明

看起來NET 4.0 之後都推薦這個方法所以就.......就是你了皮卡邱( 大誤)，ObjectCache是提供標準的介面來統一快取機制的操做，所以他只是抽象的介面底層還是實作MemoryCache，也因為如此MemoryCache有的特性他也有，也提供了很多方法可以使用 。(也因為底層實作是MemoryCache所以應該也會支援分散架構)。 

MSND說明 ：內建 MemoryCache 類別衍生自 ObjectCache 類別。 MemoryCache 類別是在只有具象物件快取實作 .NET Framework 4 衍生自 ObjectCache 類別。(參考資訊：https://msdn.microsoft.com/zh-tw/library/system.runtime.caching.objectcache(v=vs.110).aspx)



ObjectCache 新增

注意的事項(新增注意事項是我直接引用別人部落格的資訊，我也有貼上引用來源，如果有侵權的話麻煩告知我，我會拿下來)
1. 加入快取 (Set, Add, AddOrGetExisting)
Set (快取已存在時，直接覆寫)
Cache[key]=value  (快取已存在時，直接覆寫，但無法設定 CacheItemPolicy)
Add (快取已存在時，不會覆寫原有設定，會回傳false結果告知新增失敗)
引用來源：https://dotblogs.com.tw/wasichris/2015/11/14/153922(個人覺得這篇寫的非常的棒，其實可以直接看他這篇比較清楚)


ObjectCache  設定快取回收規則
類型            方法               說明                        範例
CacheItemPolicy AbsoluteExpiration 設定多久時間後cache被回收   ObjectCache cache2 = MemoryCache.Default;
                                                               var policy = new CacheItemPolicy();//設定回收時間
                                                               //多久時間清除快取項目
                                                               policy.AbsoluteExpiration = DateTimeOffset.Now.AddSeconds(15.0);
                                                               cache2.Set("test", "testing", policy);
CacheItemPolicy SlidingExpiration  多久時間沒有使用cache就回收 ObjectCache cache2 = MemoryCache.Default;
                                                               //設定回收時間
                                                               var policy = new CacheItemPolicy();
                                                               //多久時間cache沒有被使用就回收
                                                               policy.SlidingExpiration = TimeSpan.FromSeconds(5);
                                                               cache2.Set("test", "testing", policy);
CacheItemPolicy NotRemovable       (未接受任務)                (未接受任務)
參考資訊：https://msdn.microsoft.com/zh-tw/library/system.runtime.caching.cacheitempolicy(v=vs.110).aspx


ObjectCache  其他
類型        方法                說明                                                 範例
MemoryCache CacheMemoryLimit    取得電腦上可供快取使用的記憶體數量(以位元組為單位)。 ObjectCache cache2 = MemoryCache.Default;
                                                                                     var cacheMemoryLimit = (cache2 as MemoryCache).CacheMemoryLimit;
MemoryCache PhysicalMemoryLimit 快取可使用的實體記憶體百分比。                       ObjectCache cache2 = MemoryCache.Default;
                                                                                      var PhysicalMemoryLimit = (cache2 as MemoryCache).PhysicalMemoryLimit ;


ObjectCache  設定預設值


屬性                          描述
CacheMemoryLimitMegabytes     MemoryCache 物件執行個體可以成長的最大記憶體大小 (MB)。 預設值為 0，表示預設會使用 MemoryCache 類別的自動調整啟發學習法。
Name                          快取組態的名稱。
PhysicalMemoryLimitPercentage 快取可使用的實體記憶體百分比。 預設值為 0，表示預設會使用MemoryCache 類別的自動調整啟發學習法。
PollingInterval               表示時間間隔的值， 在此時間之後，快取實作會比較目前的記憶體負載與針對快取執行個體所設定的絕對和百分比型記憶體限制。 此值是以 "HH:MM:SS" 格式輸入。
參考資訊https://docs.microsoft.com/zh-tw/dotnet/framework/configure-apps/file-schema/runtime/memorycache-element-cache-settings


範例
<system.runtime.caching>
<memoryCache>
<namedCaches>
<add name="Default"
cacheMemoryLimitMegabytes="10"
physicalMemoryLimitPercentage="0"
pollingInterval="00:05:00" />
</namedCaches>
</memoryCache>
</system.runtime.caching>


實驗室列表




程式名稱                            說明                                                                              實驗結果
ConsoleApp_Cache_AbsoluteExpiration AbsoluteExpiration 多久時間後cache被回收                                          成功
ConsoleApp_Cache_SlidingExpiration  SlidingExpiration 多久時間沒有使用cache就回收                                     成功
ConsoleApp_Cache_SetConfig          WebConfig 設定 Cache 然後使用 CacheMemoryLimit 及 PhysicalMemoryLimit來觀察是變化 失敗
ConsoleApp_Cache_Remove             Cache_Remove 當資料異動(移除)時使用自訂方法處理移除資訊                           成功
實驗 Source Code(GitHub)： https://github.com/ZeroTiem/CacheExercise



實驗結果

說明：AbsoluteExpiration 多久時間後cache被回收
程式名稱：ConsoleApp_Cache_AbsoluteExpiration
Main：
           
ObjectCache cache2 = MemoryCache.Default;
            var policy = new CacheItemPolicy();//設定回收時間
            policy.AbsoluteExpiration = DateTimeOffset.Now.AddSeconds(15.0);//多久時間清除快取項目
            cache2.Set("test", "testing", policy);
            int WhileGo = 20;
            int i = 1;
            while (i <= WhileGo)
            {
                Thread.Sleep(1000);//延遲1000ms，也就是1秒
                Console.WriteLine("while Go " + i + " " + DateTime.Now + " cacheValue:" + cache2["test"]);
                i++;
            }
            Console.WriteLine("\n" + DateTime.Now.ToString() + "  " + cache2["test"]);
            Console.WriteLine("\n" + "End");

範例是簡單的程式，先設定當MemoryCache 15秒後就會回收，可以看到測試結果在前14次cacheValue值都還存在，那為什麼第15次並沒有出現呢?推測原因是因為我是使用Thread.Sleep(1000)這個在延遲上還要再加上程式運行的時間在第15次執行時就已經超過了15秒了，所以在第15次就已經被回收掉了。 


======================================================
說明：SlidingExpiration 多久時間沒有使用cache就回收
程式名稱：ConsoleApp_Cache_SlidingExpiration 
Main：           
ObjectCache cache2 = MemoryCache.Default;
            //設定回收時間
            var policy = new CacheItemPolicy();
            //多久時間cache沒有被使用就回收
            policy.SlidingExpiration = TimeSpan.FromSeconds(5);
            cache2.Set("test", "testing", policy);
            var goSecs = new List<int> { 4, 8, 12, 19 };
            int WhileGo = 30;
            int i = 1;
            while (i <= WhileGo)
            {
                Thread.Sleep(1000);//延遲1000ms，也就是1秒
                if (goSecs.Contains(i))
                {
                    Console.WriteLine("while Go " + i + " " + DateTime.Now + " cacheValue:" + cache2["test"]);
                }
                i++;
            }
            Console.WriteLine("\n" + "End");

執行結果


範例是簡單的程式，先設定當MemoryCache 在 5 秒內沒有被使用的話，就會回收，所以在時間 5 秒內有執行使用到都會存在，在最後一次執行我特別把秒數拉長到 7 秒就可以看到 cacheValue 沒有值了，因為超過了5秒 已經被回收了，值也就不存在了。 



==============================================================
說明：WebConfig 設定 Default 然後使用 CacheMemoryLimit 及 PhysicalMemoryLimit 來觀察是否有成功設定到 Cache 的設定值(失敗)
程式名稱：ConsoleApp_Cache_SetConfig
Main：
          
Console.WriteLine("===ConsoleApp_Cache_SetConfig===");
            ObjectCache cache2 = MemoryCache.Default;
            var physicalMemoryLimit = (cache2 as MemoryCache).PhysicalMemoryLimit;
            Console.WriteLine("physicalMemoryLimit：" + physicalMemoryLimit + "%");
            var cacheMemoryLimit = (cache2 as MemoryCache).CacheMemoryLimit;
            Console.WriteLine("cacheMemoryLimit：" + Convert.ToDouble(cacheMemoryLimit) + "Byte");
            Console.WriteLine("End");

[config 設定值1]
          
  <?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <startup>
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.1" />
    </startup>
</configuration>


設定
無
輸出
可用記憶體百分比為 99%
可用記憶體大小為 1887436800Byte 

[config 設定值2]
           
<system.runtime.caching>
    <memoryCache>
      <namedCaches>
        <add name="Default"
             cacheMemoryLimitMegabytes="0"
             physicalMemoryLimitPercentage="0"
             />
      </namedCaches>
    </memoryCache>
  </system.runtime.caching>


設定
可用記憶體百分比為 0% PS(設定0等於自動調整)
可用記憶體大小為 0 (最小單位是MB)(設定0等於自動調整)
輸出
可用記憶體百分比為 99%
可用記憶體大小為 1887436800Byte 



[config 設定值3] 無解參考
        
    <system.runtime.caching>
    <memoryCache>
      <namedCaches>
        <add name="Default"
             cacheMemoryLimitMegabytes="1"
             physicalMemoryLimitPercentage="1"
             />
      </namedCaches>
    </memoryCache>
  </system.runtime.caching>


設定
可用記憶體百分比為 1%
可用記憶體大小為 1MB (最小單位是MB)
輸出
可用記憶體百分比為 3%
可用記憶體大小為 1048576Byte = 1MB 
這是什麼詭異的狀況呢?我明明就是設定1%記憶體阿~怎麼變成3%了呢?
當兩個值有衝突時取其低值嗎? 
EX. 共 99GB 可用記憶體資源 ， 設定[可成長記憶體上限百分比 80%] 及 [可成長記憶體上限 70GB] 這樣會已 70GB 為主嗎?是否有什麼方法可以監控測試呢? 



似乎是答案
引用：
The first thing you might notice is that it doesn't even try to look at the size of the cache until after a Gen2 garbage collection, instead just falling back on the existing stored size value in cacheSizeSamples. So you won't ever be able to hit the target right on, but if the rest worked we would at least get a size measurement before we got in real trouble.
So assuming a Gen2 GC has occurred, we run into problem 2, which is that ref2.ApproximateSize does a horrible job of actually approximating the size of the cache. Slogging through CLR junk I found that this is a System.SizedReference, and this is what it's doing to get the value (IntPtr is a handle to the MemoryCache object itself):

翻譯：
您可能會注意到的第一件事是，它甚至沒有嘗試直到Gen2垃圾回收之後才查看緩存的大小，而是回退到cacheSizeSamples中的現有存儲大小值。所以你永遠不可能直接擊中目標，但是如果剩下的工作起來，我們至少可以在我們遇到麻煩之前進行尺寸測量。 因此，假設發生了Gen2 GC，我們遇到了問題2，即ref2.ApproximateSize在真正接近緩存大小方面做了一件糟糕的工作。通過CLR垃圾進行阻塞我發現這是一個System.SizedReference，這是它獲取值的過程（IntPtr是MemoryCache對象本身的句柄）

引用來源： https://stackoverflow.com/questions/6895956/memorycache-does-not-obey-memory-limits-in-configuration

相關參考：https://stackoverflow.com/questions/25225249/maxsize-of-array-in-net-framework-4-5(設定64位元編譯)
==============================================================
說明：Cache_Remove 當資料異動(移除)時使用自訂方法處理移除資訊
程式名稱：ConsoleApp_Cache_Remove
Main：
static void Main(string[] args)
        {
            ////=================多久時間回收測試=======================
            ObjectCache cache = MemoryCache.Default;
            //設定回收時間
            var policy = new CacheItemPolicy();
            //多久時間cache沒有被使用就回收
            policy.AbsoluteExpiration = DateTimeOffset.Now.AddSeconds(3.0);//多久時間清除快取項目
            policy.RemovedCallback = CacheItemRemoved;//如果資訊有移除要做什麼事情
            object objectvalue = "Data";//要存儲的資訊
            cache.Set("test", objectvalue, policy);//設定cache並且給予值
            int WhileGo = 30;
            int i = 1;
            while (i <= WhileGo)
            {
                Thread.Sleep(1000);//延遲1000ms，也就是1秒
                Console.WriteLine("while Go " + i + " " + DateTime.Now + "  cacheValue:" + cache["test"]);
                i++;
            }
            Console.WriteLine("\n" + "End");
        }
        static void CacheItemRemoved(CacheEntryRemovedArguments arguments)
        {
            // The arguments object contains information about the removed item such  as:
            var key = arguments.CacheItem.Key;
            var removedObject = arguments.CacheItem.Value;
            var removedReason = arguments.RemovedReason;
            Console.WriteLine($"[Run cacheItemRemoved] key:{ key } / removedObject:{  removedObject } / removedReason:{ removedReason }");
        }


先設定當MemoryCache 在 3秒內沒有被使用的話，MemoryCache就會被回收，當被回收時會觸發自訂的程序並且取得被回收的名稱、資料、移除資訊。
PS.這裡我也有測試關閉程式並不會觸發RemovedCallback  

所有參考資訊
參考資訊：https://dotblogs.com.tw/wasichris/2015/11/14/153922
參考資訊：https://www.codeproject.com/Articles/756423/How-to-Cache-Objects-Simply-using-System-Runtime-C
參考資訊：http://www.wenwenti.info/article/102965(設定config)
參考資訊：https://msdn.microsoft.com/en-us/library/hh852722(v=pandp.51).aspx(範例)
參考資訊：在WPF應用程序中緩存應用程序數據
DeteTime & DateTimeOffset：https://msdn.microsoft.com/zh-tw/library/bb384267(v=vs.110).aspx