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

Microsoft.Extensions.Caching.Memory：.NET 中的快取基礎

快取是在許多高性能 .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

入門指南

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

將 Microsoft.Extensions.Caching.Memory 與 IronPDF 結合使用

在 .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 可以以合理的價格購買，購買套件包括終身許可。 套件提供了極佳的價值，起始於$799，這是多個系統的一次性費用。 對於持有許可的用戶，提供全天候在線工程支持。 有關費用的更多詳細信息，請訪問IronPDF許可頁面。 訪問此Iron Software 頁面以了解有關 Iron Software 製作的產品的更多信息。