Environment Tag Helper (Tag Helper Môi trường) trong ASP.NET Core

Tác giả: Peter Kellner và Hisham Bin Ateya

Environment Tag Helper có điều kiện kết xuất (render) nội dung bên trong nó dựa trên hosting environment (môi trường lưu trữ) hiện tại. Thuộc tính duy nhất của Environment Tag Helper là names – một danh sách tên môi trường cách nhau bằng dấu phẩy. Nếu bất kỳ tên môi trường nào trong danh sách khớp với môi trường hiện tại, nội dung bên trong sẽ được kết xuất.

Để có tổng quan về Tag Helpers, xem Tag Helpers in ASP.NET Core.

Thuộc tính của Environment Tag Helper

names

names nhận một tên hosting environment hoặc danh sách tên cách nhau bằng dấu phẩy để kích hoạt việc kết xuất nội dung bên trong.

Các giá trị môi trường được so sánh với giá trị hiện tại trả về bởi IWebHostEnvironment.EnvironmentName. Phép so sánh không phân biệt chữ hoa/thường.

Ví dụ dưới đây sử dụng Environment Tag Helper. Nội dung được kết xuất nếu hosting environment là Staging hoặc Production:

<environment names="Staging,Production">
    <strong>IWebHostEnvironment.EnvironmentName is Staging or Production</strong>
</environment>

Thuộc tính include và exclude

Thuộc tính include và exclude điều khiển việc kết xuất nội dung bên trong dựa trên tên hosting environment được bao gồm hoặc loại trừ.

include

Thuộc tính include có hành vi tương tự như thuộc tính names. Môi trường được liệt kê trong giá trị của thuộc tính include phải khớp với hosting environment của ứng dụng (IWebHostEnvironment.EnvironmentName) để kết xuất nội dung của thẻ <environment>.

<environment include="Staging,Production">
    <strong>IWebHostEnvironment.EnvironmentName is Staging or Production</strong>
</environment>

exclude

Ngược lại với thuộc tính include, nội dung của thẻ <environment> được kết xuất khi hosting environment không khớp với bất kỳ môi trường nào được liệt kê trong giá trị của thuộc tính exclude.

<environment exclude="Development">
    <strong>IWebHostEnvironment.EnvironmentName is not Development</strong>
</environment>