คำถามติดแท็ก xml-documentation

เมื่อเขียนเอกสาร xml คุณสามารถใช้<see cref="something">something</see>งานได้แน่นอน แต่คุณจะอ้างอิงคลาสหรือวิธีที่มีประเภททั่วไปได้อย่างไร public class FancyClass<T> { public string FancyMethod<K>(T value) { return "something fancy"; } } ถ้าฉันจะเขียนเอกสาร xml ที่ไหนสักแห่งฉันจะอ้างอิงคลาสแฟนซีได้อย่างไร? ฉันจะอ้างอิงกได้FancyClass<string>อย่างไร วิธีการเกี่ยวกับอะไร? FancyClass<int>ยกตัวอย่างเช่นในชั้นเรียนที่แตกต่างกันผมอยากที่จะให้ความรู้ผู้ใช้ว่าผมจะกลับมาตัวอย่างของ ฉันจะทำสิ่งที่เห็น cref สำหรับที่?

198 c#  generics  reference  xml-documentation 

ควรจะง่ายกว่านี้ ... ฉันต้องการเพิ่มตัวแบ่งบรรทัด "รหัส" ลงในเอกสาร XML ในรหัสของฉัน /// <summary> /// Get a human-readable variant of the SQL WHERE statement of the search element. <br/> /// Rather than return SQL, this method returns a string with icon-tokens, which /// could be used to represent the search in a condensed pictogram format. …

197 c#  .net  xml-documentation 

เอกสารสำหรับการเปิดใช้บูรณาการ XMLDOC เป็นโครงการ Api เว็บของคุณจะปรากฏขึ้นเพื่อสถานการณ์ที่จับเฉพาะที่ทุกประเภท API ของคุณเป็นส่วนหนึ่งของโครงการ WebAPI ของคุณ โดยเฉพาะอย่างยิ่งจะกล่าวถึงวิธีการกำหนดเส้นทางเอกสาร XML ใหม่App_Data/XmlDocument.xmlและการยกเลิกการใส่เครื่องหมายบรรทัดใน config ของคุณที่จะใช้ไฟล์นั้น โดยปริยายนี้อนุญาตให้ใช้ไฟล์เอกสารของโครงการเดียวเท่านั้น อย่างไรก็ตามในการตั้งค่าของฉันฉันมีคำขอและประเภทการตอบกลับที่กำหนดไว้ในโครงการ "โมเดล" ทั่วไป ซึ่งหมายความว่าหากฉันมีจุดสิ้นสุดที่กำหนดไว้เช่น: [Route("auth/openid/login")] public async Task<AuthenticationResponse> Login(OpenIdLoginRequest request) { ... } ที่OpenIdLoginRequestกำหนดไว้ในโครงการ C # แยกต่างหากดังนี้: public class OpenIdLoginRequest { /// <summary> /// Represents the OpenId provider that authenticated the user. (i.e. Facebook, Google, …

102 c#  asp.net-web-api  xml-documentation 

ปิด . คำถามนี้เป็นคำถามความคิดเห็นตาม ขณะนี้ยังไม่ยอมรับคำตอบ ต้องการปรับปรุงคำถามนี้หรือไม่ อัปเดตคำถามเพื่อให้สามารถตอบได้ด้วยข้อเท็จจริงและการอ้างอิงโดยแก้ไขโพสต์นี้นี้ ปิดให้บริการใน2 ปีที่ผ่านมา ปรับปรุงคำถามนี้ มีวิธีอัตโนมัติในการซิงค์ความคิดเห็นระหว่างอินเทอร์เฟซและการใช้งานหรือไม่ ฉันกำลังจัดทำเอกสารทั้งคู่และไม่ต้องการให้ซิงค์ด้วยตนเอง อัพเดท: พิจารณารหัสนี้: interface IFoo{ /// <summary> /// Commenting DoThis method /// </summary> void DoThis(); } class Foo : IFoo { public void DoThis(); } เมื่อฉันสร้างชั้นเรียนเช่นนี้: IFoo foo=new Foo(); foo.DoThis();//comments are shown in intellisense ความคิดเห็นที่นี่จะไม่แสดง: Foo foo=new Foo(); foo.DoThis();//comments are …

98 c#  documentation  xml-documentation