আমি সি # তে এক্সএমএল মন্তব্যের জন্য সেরা অনুশীলনের একটি সুপারিশ খুঁজছি। আপনি যখন কোনও সম্পত্তি তৈরি করেন, মনে হয় প্রত্যাশিত এক্সএমএল ডকুমেন্টেশনের নিম্নলিখিত ফর্মটি রয়েছে:
/// <summary>
/// Gets or sets the ID the uniquely identifies this <see cref="User" /> instance.
/// </summary>
public int ID {
get;
set;
}
কিন্তু কি অপারেশন ক্লাসের বাইরের গ্রাহকদের পাওয়া যায় যেহেতু সম্পত্তির স্বাক্ষর ইতিমধ্যে আপনি বলে (এই ক্ষেত্রে এটি উভয় get
এবং set
) আমি মনে করি মন্তব্য মতো সহজেই অবাঞ্ছিত এবং যে সম্ভবত নিম্নলিখিত যথেষ্ট হবে:
/// <summary>
/// ID that uniquely identifies this <see cref="User" /> instance.
/// </summary>
public int ID {
get;
set;
}
মাইক্রোসফ্ট প্রথম ফর্মটি ব্যবহার করে তাই দেখে মনে হচ্ছে এটি একটি অন্তর্নিহিত কনভেনশন। তবে আমি মনে করি যে আমি বলেছি যে কারণে দ্বিতীয়টি ভাল।
আমি বুঝতে পারি যে এই সারিটি গঠনমূলক না হিসাবে চিহ্নিত হওয়ার জন্য পারদর্শী, তবে যে কোনও সংখ্যার যে মন্তব্য করতে হবে তার পরিমাণ বিশাল এবং তাই আমি বিশ্বাস করি যে এই প্রশ্নের এখানে থাকার অধিকার রয়েছে।
আমি অফিসিয়াল প্রস্তাবিত অনুশীলনের কোনও ধারণা বা লিঙ্কগুলির প্রশংসা করব।
gets or sets
বা gets
নির্ভর সম্পত্তি accessors উপর।