Nhận sự thật với hướng dẫn từng bước này
Nếu bạn quan tâm đến việc thêm nhận xét tham chiếu vào mã XML của mình, hãy sử dụng hướng dẫn từng bước này để được hướng dẫn. Bạn có thể tìm hiểu cách thực hiện chức năng này chỉ trong năm phút. Mặc dù quá trình này dễ dàng hoàn thành nhưng bạn vẫn nên biết một số khái niệm cơ bản về nhận xét XML và tính hữu ích của chúng trước khi bạn bắt đầu.
Tại sao nhận xét XML hữu ích
Nhận xét trong XML gần giống với các nhận xét trong HTML, vì cả hai đều có cùng cú pháp. Sử dụng nhận xét cho phép bạn hiểu mã bạn đã viết năm trước. Nó cũng có thể giúp một nhà phát triển khác xem xét mã bạn đã phát triển hiểu những gì bạn đã viết. Tóm lại, những nhận xét này cung cấp ngữ cảnh cho mã.
Với nhận xét, bạn có thể dễ dàng để lại ghi chú hoặc tạm thời xóa một phần của mã XML. Mặc dù XML được thiết kế để "tự mô tả dữ liệu", đôi khi bạn có thể cần phải để lại nhận xét XML.
Bắt đầu
Thẻ nhận xét bao gồm hai phần: phần bắt đầu nhận xét và phần kết thúc nhận xét . Để bắt đầu, hãy thêm phần đầu tiên của thẻ nhận xét bất kỳ nhận xét nào bạn muốn. Chỉ cần đảm bảo bạn không lồng nhận xét trong các nhận xét khác (xem mẹo để biết thêm chi tiết).
Sau đó, bạn sẽ đóng thẻ nhận xét ->
Lời khuyên hữu ích
Khi thêm các chú thích tham chiếu vào mã XML của bạn, hãy nhớ rằng chúng không thể xuất hiện ở đầu tài liệu của bạn. Trong XML, chỉ khai báo XML mới có thể đến trước:
Như đã đề cập ở trên, các bình luận có thể không được lồng vào nhau. Bạn phải đóng bình luận đầu tiên trước khi mở một giây. Ngoài ra, các nhận xét không thể xảy ra trong các thẻ, ví dụ:
Không bao giờ sử dụng hai dấu gạch ngang (-) ở bất kỳ nơi nào trừ khi bắt đầu và kết thúc nhận xét của bạn. Bất cứ điều gì trong các bình luận là vô hình một cách hiệu quả với trình phân tích cú pháp XML, vì vậy hãy cẩn thận rằng những gì còn lại vẫn còn hợp lệ và được định dạng tốt.
Gói lên
Nếu bạn vẫn có câu hỏi về việc thêm nhận xét tham chiếu vào mã XML, bạn có thể muốn đọc một cuốn sách để cung cấp cho bạn một bức tranh chi tiết về cách thức hoạt động của quy trình. Những cuốn sách như Tài liệu tham khảo Lập trình C # 5.0 của Rod Stephens có thể hữu ích. Kiểm tra các nhà bán lẻ trực tuyến hoặc thư viện địa phương của bạn để tìm các sách tương tự.