8

Есть описанное перечисление. Например:

public enum Duration { S , D, F }

Необходимо, чтобы в сплывающих подсказках автозаполнения было описание каждого элемента..

Вот как это выглядит сейчас.

введите сюда описание изображения

Хотелось бы, чтобы выглядело как тут:

введите сюда описание изображения

В сплывающей подсказке поясняется что означает данный элемент перечисления. Как подобное описание добавить к своим enum?

Нужно, чтобы описание было доступно в стороннем проекте при подключении данного (переносимая библиотека) в виде собранного dll.

3 ответа 3

11
public enum Duration
{
    /// <summary>
    /// Text
    /// </summary>
    S,
    /// <summary>
    /// Text
    /// </summary>
    D,
    /// <summary>
    /// Text
    /// </summary>
    F
}
5

Вот так:

public enum Duration
{
    /// <summary>
    /// Это S
    /// </summary>
    S,
    /// <summary>
    /// А вот это D
    /// </summary>
    D,
    /// <summary>
    /// А вот тут вообще F
    /// </summary>
    F
}

все любят картинки

19
  • У меня почему-то не выводит =(
    – MrModest
    21 фев 2017 в 15:35
  • @Mr.Modest: А вы поставили именно тройной слеш?
    – VladD
    21 фев 2017 в 15:36
  • да.. вот так: pastexen.com/code.php?file=L0sTRPT8Si.cs
    – MrModest
    21 фев 2017 в 15:37
  • посмотрите по ссылке.. SO вёрстку похерил, поэтому я дал ссылку на листинг
    – MrModest
    21 фев 2017 в 15:39
  • @Mr.Modest: С вашим кодом выходит так: i.stack.imgur.com/C62h2.png. А вы держите мышку точно над S?
    – VladD
    21 фев 2017 в 15:40
3

Для того, чтобы документация из внешней dll работала в сторонних проектах, необходимо включить генерацию XML-документа при сборке.

По умолчанию создание xml-файла из комментариев отключено. Его нужно включить в свойствах проекта на вкладке Build.

В результате при компиляции, в дополнение к файлу вашей сборки, будет сгенерирован xml-файл, который содержит все xml-комментарии из кода (в том числе комментарии к непубличным структурам). Этот файл уже сам по себе полезен тем, что если его положить рядом со сборкой (вашей dll), то это позволит функции IntelliSense в Visual Studio отображать описания для методов в момент набора пользователем кода.

Информация взята из статьи: https://habrahabr.ru/post/102177/ Там также есть прочая полезная инфа по составлению документации на C#

4
  • Если вы пишете проект и в вашем же проекте создадите xml комментарии, то они у вас начинают работать сразу, для этого даже не надо создавать xml-файл при компиляции. Обратите внимание на ответ @VladD
    – Bulson
    21 фев 2017 в 17:47
  • @Bulson, суть в том, что мне было нужно, чтобы комментарии из переносимой библиотеки были видны в другом проекте, в котором я просто подключаю собранную dll.
    – MrModest
    21 фев 2017 в 17:59
  • А ну в этом случае, так. В вашем вопросе изначально не было никакой информации о том, что вы пишете библиотеку для других. Потому я и оставил такой комментарий.
    – Bulson
    21 фев 2017 в 18:04
  • 1
    @Bulson, потому что, когда задавал вопрос, не знал, что для библиотеки в этом плане есть свои особенности.
    – MrModest
    21 фев 2017 в 18:21

Ваш ответ

Нажимая на кнопку «Отправить ответ», вы соглашаетесь с нашими условиями использования и подтверждаете, что прочитали и поняли наши политику конфиденциальности и нормы поведения.

Всё ещё ищете ответ? Посмотрите другие вопросы с метками или задайте свой вопрос.