.NET

Question

لديك واحدة مثيرة للاهتمام.أنا توثق طريقة باستخدام تعليقات وثائق XML في C #.أريد استخدام التوجيه لتضمين جميع محتويات الملف المشار إليه.أقوم بتوثيق جزء من التعليمات البرمجية التي تتلقى سلسلة تنسيق كمستند XML، وأريد تضمين ملف XSD في وثائق المعلمة.

هذا يعمل بشكل جيد في أن XML الذي تم إنشاؤه بواسطة Visual Studio هو كما أتوقع.إليك مقتطف XML: giveacodicetagpre.

ومع ذلك، عندما أستخدم Sandcastle لإنشاء ملف تعليمات من هذا، لا يتم عرض محتويات ملف XSD، ولكن Sandcastle لا يبلغ عن أي أخطاء.لقد حاولت استخدام اسم الملف بالنسبة إلى حيث تكون ملفات التعليمات كذلك، أي

ولكن بعد ذلك يشكو Visual Studio أنه لا يمكن العثور على الملف.أنا وضعت لهم في كلتا المكانين ولا يزال الملف المضمن لا يظهر.

أي أفكار؟

Answer 1

The include tag is processed at compiler time, so the generated XML file should contain all of its referred contents. Hence you have to put your XSD folder relative to the C# source file, then the compiler won't show any errors. After this, Sandcastle will be able to create the help file from the single XML document.