Microsoft.Extensions.Caching.Memory 示例 (含 PDF) in C#

Microsoft.Extensions.Caching.Memory: .NET 快取基礎

快取（Caching）是許多高效能 .NET 應用程式中使用的一種方法，可將經常存取的資料儲存在記憶體中以便快速檢索。 Microsoft.Extensions 是眾多可用的快取選項之一。 Caching.Memory 是特別強大且適應性強的選擇。 該庫是更大的 Microsoft.Extensions.Caching 命名空間的一個元件，提供了一種簡單而有效的記憶體快取方法。

"Microsoft.Extensions.Caching.Memory" 中的鍵類型

安裝與設定 Microsoft.Extensions.Caching.Memory

在應用程式啟動時，會使用記憶體在 ASP.NET Core 應用程式的服務集合內設定快取服務。 以下是一個設定了 Microsoft.Extensions.Caching.Memory 的 ASP.NET Core 應用程式：

Install-Package Microsoft.Extensions.Caching.Memory

using Microsoft.Extensions.Caching.Memory;
public void ConfigureServices(IServiceCollection services)
{
    // Add memory cache service
    services.AddMemoryCache();
    // Other service configurations...
}

using Microsoft.Extensions.Caching.Memory;
public void ConfigureServices(IServiceCollection services)
{
    // Add memory cache service
    services.AddMemoryCache();
    // Other service configurations...
}

Imports Microsoft.Extensions.Caching.Memory
Public Sub ConfigureServices(ByVal services As IServiceCollection)
	' Add memory cache service
	services.AddMemoryCache()
	' Other service configurations...
End Sub

public class MyService
{
    private readonly IMemoryCache _cache;
    public MyService(IMemoryCache cache)
    {
        _cache = cache;
    }
    // Use _cache to perform caching operations...
}

public class MyService
{
    private readonly IMemoryCache _cache;
    public MyService(IMemoryCache cache)
    {
        _cache = cache;
    }
    // Use _cache to perform caching operations...
}

Public Class MyService
	Private ReadOnly _cache As IMemoryCache
	Public Sub New(ByVal cache As IMemoryCache)
		_cache = cache
	End Sub
	' Use _cache to perform caching operations...
End Class

public void ConfigureServices(IServiceCollection services)
{
    // Configure cache options
    services.AddMemoryCache(options =>
    {
        options.SizeLimit = 1024; // Set the maximum size limit for the cache
        options.CompactionPercentage = 0.75; // Set the percentage of memory to free up when the cache size exceeds the limit
        options.ExpirationScanFrequency = TimeSpan.FromMinutes(5); // Set how often the cache should scan for expired items
    });
    // Other service configurations...
}

public void ConfigureServices(IServiceCollection services)
{
    // Configure cache options
    services.AddMemoryCache(options =>
    {
        options.SizeLimit = 1024; // Set the maximum size limit for the cache
        options.CompactionPercentage = 0.75; // Set the percentage of memory to free up when the cache size exceeds the limit
        options.ExpirationScanFrequency = TimeSpan.FromMinutes(5); // Set how often the cache should scan for expired items
    });
    // Other service configurations...
}

Public Sub ConfigureServices(ByVal services As IServiceCollection)
	' Configure cache options
	services.AddMemoryCache(Sub(options)
		options.SizeLimit = 1024 ' Set the maximum size limit for the cache
		options.CompactionPercentage = 0.75 ' Set the percentage of memory to free up when the cache size exceeds the limit
		options.ExpirationScanFrequency = TimeSpan.FromMinutes(5) ' Set how often the cache should scan for expired items
	End Sub)
	' Other service configurations...
End Sub

開始

什麼是 IronPDF？

Install-Package IronPdf

using IronPdf;
public void ConfigureServices(IServiceCollection services)
{
    // Configure IronPDF
    services.AddSingleton<HtmlToPdf>();
    // Other service configurations...
}

using IronPdf;
public void ConfigureServices(IServiceCollection services)
{
    // Configure IronPDF
    services.AddSingleton<HtmlToPdf>();
    // Other service configurations...
}

Imports IronPdf
Public Sub ConfigureServices(ByVal services As IServiceCollection)
	' Configure IronPDF
	services.AddSingleton(Of HtmlToPdf)()
	' Other service configurations...
End Sub

使用 IronPDF 的 Microsoft.Extensions.Caching.Memory

在 .NET 應用程式中，Microsoft.Extensions.Caching.Memory 提供了一種儲存頻繁請求的資料以便更快檢索的實用方法。

using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Caching.Memory;
using System.Net;
using System.Net.Http.Headers;
using IronPdf;

namespace DemoWebApplication.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class DemoController : ControllerBase
    {
        private readonly IMemoryCache _cache;
        private readonly HtmlToPdf _htmlToPdf;
        private readonly ILogger<DemoController> _logger;

        public DemoController(ILogger<DemoController> logger, IMemoryCache cache, HtmlToPdf htmlToPdf)
        {
            _logger = logger;
            _cache = cache;
            _htmlToPdf = htmlToPdf;
        }

        [HttpGet]
        public FileContentResult Generate()
        {
            string fileName = "Sample.pdf";
            var stream = GeneratePdf("Hello IronPDF");
            return new FileContentResult(stream, "application/octet-stream")
            {
                FileDownloadName = fileName
            };
        }

        private byte[] GeneratePdf(string htmlContent)
        {
            // Object key
            string cacheKey = "GeneratedPdf";
            if (!_cache.TryGetValue(cacheKey, out byte[] pdfBytes))
            {
                // PDF not found in cache, generate it
                var pdfDocument = _htmlToPdf.RenderHtmlAsPdf(htmlContent);
                pdfBytes = pdfDocument.BinaryData;
                // Cache the generated PDF with a sliding expiration of 1 hour
                _cache.Set(cacheKey, pdfBytes, TimeSpan.FromHours(1));
            }
            return pdfBytes;
        }
    }
}

using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Caching.Memory;
using System.Net;
using System.Net.Http.Headers;
using IronPdf;

namespace DemoWebApplication.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class DemoController : ControllerBase
    {
        private readonly IMemoryCache _cache;
        private readonly HtmlToPdf _htmlToPdf;
        private readonly ILogger<DemoController> _logger;

        public DemoController(ILogger<DemoController> logger, IMemoryCache cache, HtmlToPdf htmlToPdf)
        {
            _logger = logger;
            _cache = cache;
            _htmlToPdf = htmlToPdf;
        }

        [HttpGet]
        public FileContentResult Generate()
        {
            string fileName = "Sample.pdf";
            var stream = GeneratePdf("Hello IronPDF");
            return new FileContentResult(stream, "application/octet-stream")
            {
                FileDownloadName = fileName
            };
        }

        private byte[] GeneratePdf(string htmlContent)
        {
            // Object key
            string cacheKey = "GeneratedPdf";
            if (!_cache.TryGetValue(cacheKey, out byte[] pdfBytes))
            {
                // PDF not found in cache, generate it
                var pdfDocument = _htmlToPdf.RenderHtmlAsPdf(htmlContent);
                pdfBytes = pdfDocument.BinaryData;
                // Cache the generated PDF with a sliding expiration of 1 hour
                _cache.Set(cacheKey, pdfBytes, TimeSpan.FromHours(1));
            }
            return pdfBytes;
        }
    }
}

Imports Microsoft.AspNetCore.Mvc
Imports Microsoft.Extensions.Caching.Memory
Imports System.Net
Imports System.Net.Http.Headers
Imports IronPdf

Namespace DemoWebApplication.Controllers
	<ApiController>
	<Route("[controller]")>
	Public Class DemoController
		Inherits ControllerBase

		Private ReadOnly _cache As IMemoryCache
		Private ReadOnly _htmlToPdf As HtmlToPdf
		Private ReadOnly _logger As ILogger(Of DemoController)

		Public Sub New(ByVal logger As ILogger(Of DemoController), ByVal cache As IMemoryCache, ByVal htmlToPdf As HtmlToPdf)
			_logger = logger
			_cache = cache
			_htmlToPdf = htmlToPdf
		End Sub

		<HttpGet>
		Public Function Generate() As FileContentResult
			Dim fileName As String = "Sample.pdf"
			Dim stream = GeneratePdf("Hello IronPDF")
			Return New FileContentResult(stream, "application/octet-stream") With {.FileDownloadName = fileName}
		End Function

		Private Function GeneratePdf(ByVal htmlContent As String) As Byte()
			' Object key
			Dim cacheKey As String = "GeneratedPdf"
			Dim pdfBytes() As Byte
			If Not _cache.TryGetValue(cacheKey, pdfBytes) Then
				' PDF not found in cache, generate it
				Dim pdfDocument = _htmlToPdf.RenderHtmlAsPdf(htmlContent)
				pdfBytes = pdfDocument.BinaryData
				' Cache the generated PDF with a sliding expiration of 1 hour
				_cache.Set(cacheKey, pdfBytes, TimeSpan.FromHours(1))
			End If
			Return pdfBytes
		End Function
	End Class
End Namespace

我們匯入與 Microsoft 和 ASP.NET 一起工作所需的命名空間 Microsoft.Extensions.Caching.Memory。 我們創建了 DemoController 控制器，該控制器派生自 ControllerBase。 此控制器將回應透過 HTTP 發送的查詢。 IMemoryCache 的一個實例被注入到控制器的建構函數中。

為了控制服務（包括記憶體快取）的生命週期，ASP.NET Core 提供了依賴注入功能。 應用 [HttpGet] 屬性後，Generate 方法被標記為處理來自指定路由 (/Demo) 的對商店的 HTTP GET 請求。 我們嘗試使用給定的快取記憶體金鑰從快取記憶體中取得 PDF 資料。 如果快取中找不到數據，我們將使用 GeneratePdf 函數建立新的 PDF。

在有多台應用程式伺服器的情況下，請務必設定分散式快取，以便在所有伺服器上進行一致的快取處理。

若要使用 Microsoft.Extensions.Caching.Memory，請參閱提供的文件和範例程式碼，以快取資料並提高 ASP.NET Core 應用程式的效能。 實際上，您可以調整到期政策、快取金鑰和快取行為，以符合您應用程式的需求。 對於產生成本較高或經常被多個執行緒存取的資料進行快取，可以改善整體使用者體驗，並大幅縮短回應時間。

結論

綜上所述，Microsoft.Extensions.Caching.Memory 可用於提高 .NET 應用程式的可擴充性和效能，特別是那些基於 ASP.NET Core 框架的應用程式。 開發人員可以利用記憶體快取改善使用者體驗、減少延遲並優化資料存取。 該函式庫提供靈活且易於使用的 API，可針對特定應用程式需求開發快取策略，無論是快取參考資料、查詢結果或計算值。 透過採用快取最佳實踐並將 Microsoft.Extensions.Caching.Memory 添加到您的 .NET 應用程式中，您可以實現明顯的速度提升和增強應用程式回應能力。

透過利用 Microsoft.Extensions 的各項功能，透過 IronPDF 的動態 PDF 建立功能和 Caching.Memory 的高效資料快取功能，.NET 開發人員可以大幅提升應用程式的運行速度。這種強大的組合能夠幫助開發人員輕鬆設計高效能、可擴展且回應迅速的應用程式，從而降低伺服器負載、改善使用者體驗並消除處理開銷。

IronPDF 可以合理的價格購買，取得套件包括終身授權。 該套餐物超所值，起價僅為 $999，多個系統只需支付一次費用。 對於擁有授權的使用者，它提供全天候的線上工程協助。 有關收費的詳細資訊，請造訪 IronPDF 授權頁面。 請造訪這個關於 Iron Software 的頁面，瞭解 Iron Software 所製造產品的更多資訊。