Форум программистов, компьютерный форум, киберфорум
Наши страницы

C# для начинающих

Войти
Регистрация
Восстановить пароль
 
polsok
3 / 3 / 1
Регистрация: 20.03.2011
Сообщений: 348
#1

Как документировать пространство имен - C#

16.12.2012, 11:37. Просмотров 771. Ответов 8
Метки нет (Все метки)

C#
1
2
3
4
5
6
7
8
9
10
11
12
13
14
namespace Person
{
    /// <summary>
    /// Здесь создается объект Person
    /// </summary>
    class Person
    {
        Person_topping Object = new Person_topping();
            public Person() {}
            public int Age { get; set; }
            public string Name { get; set; }
            public string Gender { get; set; }
        }
    }
Как добавить XML комментарий к namespace Person?
0
Надоела реклама? Зарегистрируйтесь и она исчезнет полностью.
Similar
Эксперт
41792 / 34177 / 6122
Регистрация: 12.04.2006
Сообщений: 57,940
16.12.2012, 11:37
Я подобрал для вас темы с готовыми решениями и ответами на вопрос Как документировать пространство имен (C#):

Как добавить пространство имен using System.Diagnostics - C#
Здравствуйте, не могу понять как добавить пространство имен using System.Diagnostics, через &quot;Добавить ссылку&quot; нет его(помогите...

Как подключить пространство имен System.Windows.Media - C#
Хотел поработать с system.windows.media.animation, но не смог подключить пространство имен. Даже windows.media нету, смотрел в ссылках -...

Пространство имен не может непосредственно содержать такие члены, как поля или методы - C#
int NumberOfLegs ( string animalName) { if (animalName == &quot;слон&quot;) { return 4; } else if (animalName == &quot;Индейка&quot;) { return...

If (i ==2) Ошибка: пространство имен не может непосредственно содержать такие члены, как поля или методы - C#
using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; namespace...

Ошибка «Пространство имен не может непосредственно содержать такие члены, как поля или методы» - C#
Добрый день! C# Visual Studio 2010 Программа выдает ошибки: Ошибка 1 Пространство имен не может непосредственно содержать такие...

Ошибка в программе. Пространство имен не может непосредственно содержать такие члены, как поля или методы - C#
вот код программы using System.IO; using System.IO.Ports; System.IO.Ports.SerialPort port = new System.IO.Ports.SerialPort(); ...

8
n1l
135 / 137 / 4
Регистрация: 26.07.2010
Сообщений: 911
16.12.2012, 11:45 #2
Никак, это не возможно.
0
polsok
3 / 3 / 1
Регистрация: 20.03.2011
Сообщений: 348
16.12.2012, 12:01  [ТС] #3
Очень жаль(((
неужели мелкомягкие не продумали это
0
n1l
135 / 137 / 4
Регистрация: 26.07.2010
Сообщений: 911
16.12.2012, 12:05 #4
А зачем там комментарии, это вообще не нужно.
Прочитайте code convensions для .net и c#. В особенности как наименовать пространства имен и вы сами поймете, что комментарии в них - это лишнее.


C#
1
2
3
    /// <summary>
    /// Здесь создается объект Person
    /// </summary>
Кстати это в корне не правильная запись. Объект в классе не создается.
0
elp
1 / 1 / 1
Регистрация: 27.07.2013
Сообщений: 8
27.07.2013, 14:03 #5
n1l, здесь вопрос идет не о комментировании, а о документировании.
С Sandcastle Help File Builder получается не очень понятно для страницы неймспейса
0
n1l
135 / 137 / 4
Регистрация: 26.07.2010
Сообщений: 911
27.07.2013, 20:05 #6
Вы знаете что такое xml документация?
0
elp
1 / 1 / 1
Регистрация: 27.07.2013
Сообщений: 8
27.07.2013, 22:54 #7
Вот именно об этом я и спрашиваю... Можно ли написать в проекте summary для пространства имен, чтобы оно ушло в xml-документацию?
Дабы не было отсылок на code convensions и прочие первоисточники, поясню ситуацию... С помощью Sandcastle Help File Builder пытаюсь собрать из xml документацию в формате chm... При сборке SHFB выдает предупреждение Warn: ShowMissingComponent: [N:elp.Yandex.Translate] Missing <summary> documentation. Соответствующая страница namespace'a получается не очень...
0
n1l
135 / 137 / 4
Регистрация: 26.07.2010
Сообщений: 911
28.07.2013, 08:31 #8
А я об этом и говорю, что нельзя. Документация складывается из xml комментариев, специально для namespace'ов их нет. Вы можете выйти из положения другим способом, путем каких-то хитросплетений.
Например создать класс YourNamespaceDoc и в нем прокомментировать каждый тип в этом namespac'e в качестве свойства.

C#
1
2
3
4
5
6
7
8
9
10
11
   ///<summary>
   ///this namespace is just for lulz
   ///</summary>
  YourNamespaceDoc
  {
    ///<>
    ///
    ///
    public YourFirstClass YouFirstClass{get;set;}
    public YourSecondClass YouSecondClass{get;set;}
  }
0
elp
1 / 1 / 1
Регистрация: 27.07.2013
Сообщений: 8
28.07.2013, 20:30 #9
n1l, ясно Спасибо за помощь
0
28.07.2013, 20:30
MoreAnswers
Эксперт
37091 / 29110 / 5898
Регистрация: 17.06.2006
Сообщений: 43,301
28.07.2013, 20:30
Привет! Вот еще темы с ответами:

пространство имен - C#
Кто-нибудь знает какие using System. надо использовать для этого? windows = WindowHelper.EnumerateTopWindows();

Пространство имен - C#
Как собственно сделать что бы &quot;string ch = my.change + &quot;.txt&quot;;&quot; было что я написал, а не &quot;null.txt&quot;. Если в одном классе размещенно, то...

Пространство имен - C#
Добрый день. Стоит у меня VS Express 2010, MS Server 2008, SQL Management Studio Express 2008. Пишу на шарпе приложение с базой данных. VS...

Пространство имен - C#
&quot;Terrasodt.Core.DB.Query&quot; не содержит определение для &quot;ExecuteReader&quot;. Не удалось найти метод расширения &quot;ExecuteReader&quot;, принимающий...


Искать еще темы с ответами

Или воспользуйтесь поиском по форуму:
9
Ответ Создать тему
Опции темы

КиберФорум - форум программистов, компьютерный форум, программирование
Powered by vBulletin® Version 3.8.9
Copyright ©2000 - 2018, vBulletin Solutions, Inc.
Рейтинг@Mail.ru