طريقة لنسخ تعليقات XML من مجموعة من واجهات برمجة التطبيقات إلى مجموعة أخرى مماثلة من واجهات برمجة التطبيقات؟

Question

لنفترض في Visual Studio ، لدي مشروع جديد يحتوي على بعض من نفس واجهات برمجة التطبيقات من مشروع أقدم ، وأود أن نسخ وثائق XML إلى The New. هل هناك طريقة يمكنني القيام بذلك دون نسخها يدويًا واحدًا تلو الآخر؟

Answer 1

أحتفظ بمشروع مفتوح المصدر الذي ينفذ ميزة تدعم الوصول البرمجي إلى تعليقات مستند XML. يرى jolt.net لمزيد من المعلومات حول المشروع ، وتحديدا "،"الاستعلام عن تعليقات XML Doc"للحصول على وثائق هذه الميزة.

فيما يلي مثال على كيفية استخدام المكتبة لتنفيذ ما تبحث عنه.

using Jolt;
using System.Xml.Linq;

void CopyXmlDocComments(Assembly sourceAssembly)
{
    XDocument newDocComments = new XDocument();
    XmlDocCommentReader reader = new XmlDocCommentReader(sourceAssembly);

    foreach(Type t in sourceAssembly.GetTypes())  // implement type filter here
    {
        newDocComments.Add(reader.GetComments(t));
    }

    newDocComments.Save("newAssemblyName.dll.xml");
}

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

Answer 2

لم أسمع عن أي أداة من هذا القبيل. الشيء الوحيد الذي أعرفه عن ذلك متشابه عن بعد هو قدرة Resharper على نسخ تعليقات XMLDOC من الفصول الأساسية إلى الفصول المشتقة.