Góc học tập
17/05/2019 09:35:46 PM

Chỉ hướng @OutputCache trong ASP.NET

Từ khóa @OutputCache dùng để khai báo output caching của một trang ASP.NET hoặc cho một đối tượng control có tham chiếu đến đối tượng Page. Sau đây là những thông số cơ bản cho việc khai báo một đối tượng OutputCache.

<%@ OutputCache Duration="#ofseconds"

   Location="Any | Client | Downstream | Server | None |

     ServerAndClient "

   Shared="True | False"

   VaryByControl="controlname"

   VaryByCustom="browser | customstring"

   VaryByHeader="headers"

   VaryByParam="parametername"

   VaryByContentEncoding="encodings"

   CacheProfile="cache profile name | ''"

   NoStore="true | false"

   SqlDependency="database/table name pair | CommandNotification"

   ProviderName="Provider Name" 

%>

Duration

Thời hạn có hiệu lực được tính bằng giây. Đó là khoảng thời gian mà trang hoặc user controls được cache. Thiết lập những thuộc tính này trên trang hoặc user control để quy định thời hạn có hiệu lực với những phản hồi HTTP từ những đối tượng tự động cache như trên.

Thuộc tính này là bắt buộc. Nếu bạn không khai báo thuộc tính này bộ biên dịch sẽ phát sinh lỗi.

 Location

Một trong những giá trị đếm OutputCacheLocation. Mặc định của nó là Any.

Thuộc tính này không được hỗ trợ trong @OutputCache của các user controls

CacheProfile

Tên của đối tượng cache được thiết lập để kết hợp với trang. Đây là thuộc tính tuỳ chọn và có giá trị mặc định là chuỗi “”

Thuộc tính này không được hỗ trợ trong @OutputCache của các user controls. Khi được khai báo trên trang thì giá trị của nó phải khớp với tên của một trong những biến thành phần outputCacheProfiles trong phần outputCacheSettings. Nếu tên khai báo không khớp lỗi ngoại lệ sẽ xuất hiện trong quá trình chạy.

NoStore

Một biến có giá trị đúng/sai dùng để khai báo nơi lưu trữ thông tin. Thuộc tính này không được hỗ trợ trong @OutputCache của các user controls. Khi thiết lập thuộc tính này bằng true thì mã lệnh sau đây sẽ thực thi cho mỗi yêu cầu.

            Response.Cache.SetNoStore();

ProviderName

            Chuỗi dữ liệu dùng để khai báo output-cache được hiệu chỉnh bởi người dùng. Thuộc tính này được hỗ trợ trong @OutputCache của các user controls nhưng lại không được hỗ trợ trực tiếp đối với các trang ASP.NET (file .aspx)

Shared

Một giá trị Boolean xác định xem người dùng có thể kiểm soát đầu ra được chia sẻ với nhiều trang. Mặc định là false. Thuộc tính này không được hỗ trợ cho @ OutputCache chỉ hướng bao gồm trong các trang ASP.NET (tệp tin .aspx).

SqlDependency

Một chuỗi giá trị xác định một tập các cặp tên cơ sở dữ liệu và bảng mà một trang hoặc kiểm soát đầu ra của bộ nhớ cache có phụ thuộc. Giá trị CommandNotification cho SqlDependency thuộc tính chỉ có giá trị trên Web (trang  .aspx). user control chỉ có thể sử dụng phiếu dựa trên bảng với các chỉ hướng @OutputCache.

VaryByCustom

Bất kỳ văn bản đại diện cho yêu cầu bộ nhớ đệm tuỳ chỉnh. Nếu thuộc tính này được gán một giá trị của trình duyệt, bộ nhớ cache được thay đổi theo tên của trình duyệt và thông tin phiên bản chính. Nếu một chuỗi tùy biến được nhập vào, bạn phải ghi đè phương thức GetVaryByCustomString trong file Global.asax ứng dụng của bạn.

VaryByHeader

Một danh sách cách nhau bằng dấu chấm phẩy của HTTP header được sử dụng để thay đổi bộ đệm đầu ra. Khi thuộc tính này được thiết lập nhiều tiêu đề, bộ nhớ đệm đầu ra có chứa phiên bản khác nhau của các tài liệu yêu cầu theo các tiêu đề cụ thể.

Thiết lập thuộc tính cho phép các bộ nhớ đệm VaryByHeader trong tất cả các phiên bản HTTP 1.1 cache,  và nó không chỉ bộ nhớ cache ASP.NET. Thuộc tính này không được hỗ trợ cho @ OutputCache chỉ hướng của user control.