xml-documentation

В классе C# с одним конструктором я могу добавить сводную XML-документацию класса и XML-документацию конструктора: ///<summary> ///This class will solve all your problems ///</summary> public class Awesome { /// <summary> /// Initializes a new instance of the <see cref="Awesome"...

Следующий комментарий XML выдает предупреждение о времени компиляции: /// <summary> /// Provides data for the <see cref="TextDraw.Click"/> event. /// </summary> public class TextDrawEventArgs : EventArgs { //... public TextDraw TextDraw { get; private set; } } Я хочу TextDraw.Ще...

Я столкнулся с этой дилеммой, когда работал над ASP.net веб-приложение, использующее Web Client Software Factory (WCSF) в C#, и то же самое может применяться к другим платформам и языкам. Моя ситуация такова: Я определяю интерфейс представления Iдля каждой веб-страницы/пользовательского элемента управления ...

при написании XML-документации вы можете использовать <see cref="something">something</see>, который работает, конечно. Но как вы ссылаетесь на класс или метод с универсальными типами? public class FancyClass<T> { public string FancyMethod<K>(T value) { return "something fancy"; } ...

существуют ли автоматические способы синхронизации комментариев между интерфейсом и его реализацией? В настоящее время я документирую их обоих и не хотел бы вручную синхронизировать их. обновление: рассмотрим этот код: interface IFoo{ /// <summary> /// Commenting DoThis method /// </su...