Bu adım adım kılavuzla gerçekleri öğrenin
XML kodunuza referans yorumları eklemeyi düşünüyorsanız, rehberlik için bu adım adım eğiticiyi kullanın. Bu fonksiyonu sadece beş dakikada nasıl çalıştıracağınızı öğrenebilirsiniz. İşlemin tamamlanması kolay olsa da, başlamadan önce XML yorumları ve kullanışlılıkları ile ilgili bazı temel bilgileri hala bilmelisiniz.
XML Yorumlar Neden Yararlı?
XML'deki yorumlar, her ikisi de aynı sözdizimine sahip oldukları için HTML'deki yorumlarla neredeyse aynıdır. Yorumların kullanılması , daha önce yazdığınız kodu anlamanıza olanak tanır. Ayrıca, geliştirdiğiniz kodu gözden geçiren başka bir geliştiriciye yazdıklarınızı anlamasına yardımcı olabilir. Kısacası, bu yorumlar kod için bağlam sağlar.
Yorumlarla kolayca bir not bırakabilir veya bir XML kodunun bir kısmını geçici olarak kaldırabilirsiniz. XML, "kendi kendini tanımlayan veriler" olacak şekilde tasarlanmasına rağmen, bir XML yorumu bırakmanız gerekebilir.
Başlamak
Yorum etiketleri iki bölümden oluşur: yorumu başlatan kısım ve biten kısım. Başlamak için, yorumu yazın. Sadece yorumlarınızı diğer yorumlarda içmemeye dikkat edin (daha fazla ayrıntı için ipuçlarına bakın).
Bundan sonra, yorum etiketini kapatırsınız ->
Faydalı ipuçları
XML kodunuza referans yorumları eklerken, belgenizin en üstünde gelemeyeceğini unutmayın. XML'de, yalnızca XML bildirimi önce gelir:
Yukarıda belirtildiği gibi, yorumlar birbirinin içine yerleştirilemez. Bir saniye açmadan önce ilk yorumunuzu kapatmalısınız. Ayrıca, etiketler içinde yorumlar yapılamaz, örneğin
Hiçbir zaman iki tire (-) hiçbir zaman kullanmayın, ancak yorumlarınızın başında ve sonunda. Yorumlardaki herhangi bir şey XML ayrıştırıcısına etkili bir şekilde görünmez, bu yüzden kalıntıların hala geçerli ve iyi biçimlendirilmiş olmasına çok dikkat edin.
Sarma
XML koduna referans yorumları ekleme hakkında sorularınız varsa, işlemin nasıl işlediğine dair ayrıntılı bir resim vermek için bir kitap okumak isteyebilirsiniz. Rod Stephens tarafından C # 5.0 Programcının Referansı gibi kitaplar yardımcı olabilir. Benzer kitaplar için çevrimiçi satıcıları veya yerel kitaplığınızı kontrol edin.