Описание тега xmldoc

Документ XML (сокращение от комментариев к документации XML) - это комментарии, которые формируют документацию для программ на C#
4 ответа

Как я могу отключить определенное предупреждение для проекта C# в VS2012?

Я пытаюсь сгенерировать частичную документацию XML во время процесса сборки для проекта C# в VS2012. Когда я проверяю опцию файла документации XML в Project->Properties->Build, я получаю предупреждение о сборке для каждого открытого члена, у которог…
1 ответ

C# xmldoc на страницу документации

Фон: Недавно я использовал Swagger для проекта WebAPI, и мне нравится документация и ее включение в документацию XML, которую я использую в своих методах. У меня есть другие проекты, не относящиеся к WebAPI, для которых я хотел бы создать документац…
07 авг '18 в 16:32
0 ответов

Только определенные теги xmldoc имеют отношение к IntelliSense

У Microsoft есть все виды документированных тегов xml для комментариев к документам (начиная с тройного слеша), но некоторые из них (например, <list>) на самом деле не меняйте форматирование текста всплывающей подсказки, которую мне дает Intel…
18 сен '17 в 17:06
2 ответа

Самый простой способ добавить XML документ в проект WinRT

У нас есть группа разработчиков, которая переходит с C++ на C# и WinRT. Мы использовали D'Oxygen в качестве части наших сборок для разработчиков на C++, и я хотел бы продолжить создание документов в рамках сборки для разработчиков на C#/WinRT. Включ…
06 фев '13 в 21:29
2 ответа

Как заставить элемент Documentation <see /> ссылаться на тип вместо свойства с тем же именем?

Это довольно распространенная практика для имен свойств по умолчанию к имени типа, когда имя типа достаточно значимо; public class User { } public class UserSession { /// &lt;summary&gt; /// Creates a &lt;see cref="UserSession" /&gt; instance /// wi…
27 июн '13 в 09:02
1 ответ

Как определить язык программирования для элемента `<code>`

Как определить язык программирования для &lt;code&gt; элемент в XmlDocs? У меня есть примеры XML, но они выделены как C# (так как это проект C#). Пример: /// &lt;code&gt; /// &lt;![CDATA[ /// &lt;SaveConfig&gt; /// &lt;File&gt;Web.config&lt;/File&gt…
26 янв '11 в 10:40
1 ответ

Как выделить слово в xml-doc, отображаемое в подсказке?

Есть ли в xml-doc разметка для выделения (выделите жирным шрифтом, курсивом и т. Д.) Слова? Например, в: /// &lt;summary&gt; /// Bla bla... /// &lt;para&gt; /// Important: take care of the wolf. /// &lt;/para&gt; /// &lt;/summary&gt; Я не хочу, чтоб…
29 апр '16 в 16:31
1 ответ

Как попасть в другого потомка, чем 'firstChild' XML-файла в PHP?

Как я могу получить через другого потомка файла XML, чем firstChild в PHP? У меня есть такой код: $root = $xmldoc-&gt;firstChild; Могу ли я просто получить второго ребенка или другого?
02 янв '17 в 09:30
1 ответ

Использование правильного пути с пространствами имен для анализа XML (в VBA)

Я изо всех сил пытаюсь обернуть голову вокруг пространств имен и путей без разбора XML с использованием VBA. Здесь у меня есть очень простой XML... &lt;?xml version="1.0"?&gt; &lt;GetOrdersResponse xmlns="urn:ebay:apis:eBLBaseComponents"&gt; &lt;Tim…
26 сен '16 в 09:05
1 ответ

Документация по методу XML не выдает предупреждение, если имя параметра не совпадает

В VB я получу предупреждение, если имя параметра метода не соответствует документации XML: Параметр комментария XML 'arg' не соответствует параметру в соответствующем операторе 'sub'. Комментарий XML будет игнорироваться. В C# я не получаю предупреж…
27 май '16 в 13:16
2 ответа

Как я могу ссылаться на MSDN/ официальную документацию из моих комментариев к документации C# XML?

Учитывая XML-комментарий к классу что-то вроде этого: ///&lt;summary&gt;Handles the AuthenticateRequest event in the ASP.NET page request lifecycle to authenticate users.&lt;/summary&gt; ///&lt;remarks&gt; ///&lt;para&gt;This module will authenticat…
07 июл '11 в 10:58
0 ответов

Несколько сложных объектов Xml Namespaces XDocument

Я создаю документ XML с использованием объекта C# XDocument, однако пространства имен в документе действительно сложны и не могут найти подходящего решения для этого. Я пробовал искать и реализовывать ответы из других похожих тем, но, по-видимому, п…
19 июл '17 в 16:46
1 ответ

Visual Studio 2013 не делает отступ для комментариев XML после первой строки

Я думаю, что мог случайно наткнуться на какое-то нажатие клавиши в Visual Studio 2013, которое я не собирался делать. Когда я помещал /// перед методом, он автоматически создавал следующую XML-документацию перед методом: /// &lt;summary&gt; /// /// …
11 сен '14 в 10:31
1 ответ

Сериализация комментариев XmlDoc вместе с данными

У меня есть сериализуемый класс, который я хотел бы сериализовать с его данными (конечно), а также с его комментариями XmlDoc. Кто-нибудь знает о существующей библиотеке, которая выполняет эту работу, или хотя бы ее часть? Чтение XmlDoc кода C#, как…
29 окт '12 в 19:53
2 ответа

Как получить прямые дочерние элементы указанного тега в XML с помощью JQuery

Пожалуйста, проверьте код ниже. Мне нужно проверить только те дети, которые определены внутри родительского тега. Если в этом родителе появляется какой-либо неожиданный ребенок, я должен сообщить об этом как об ошибке. Это мой XML-файл: &lt;places&g…
08 окт '18 в 06:00
1 ответ

Создать пост-обработанный XML в Sandcastle?

Есть некоторые функции, такие как inheritdoc которые изначально не поддерживаются Visual Studio. Как преобразовать входной XML-файл с неподдерживаемыми тегами в его постобработанную версию, чтобы он мог быть включен в пакет выпуска?
12 мар '16 в 23:13
1 ответ

Откройте, прочитайте, измените и сохраните XML в node.js

Я пытаюсь открыть, прочитать, изменить и сохранить XML- файл в node.js. Я использую XMLDoc, но я застрял на этапе изменения и сохранения. Учитывая этот XML: &lt;widget version="1.0.0"&gt; &lt;!-- NAME --&gt; &lt;name short="Name-en"&gt;&lt;/name&gt;…
14 сен '15 в 09:50
2 ответа

IntelliSense и комментарии с тройной косой чертой в пакетах

Я разработал библиотеку кода, которую я тщательно документировал. Классы, методы и свойства комментируются с использованием тройного слэша XML (xmldoc) комментариев. /// &lt;summary&gt; /// Adds two numbers together. /// &lt;/summary&gt; /// &lt;par…
1 ответ

Использование doxygen для создания документации для существующего кода C# с комментариями XML

Я везде читал, что doxygen - это способ создания документации для кода на C#. У меня есть один интерфейс, который я хочу сначала документировать (детское пошаговое руководство), и он уже содержит комментарии XML (///). Из-за огромного количества пос…
31 авг '11 в 13:03
2 ответа

Как / при каких обстоятельствах тег <see> в комментариях Delphi xml на самом деле работает?

Интересно, как работают эти XML-ссылки, я просто не понимаю, почему они работают или почему они не работают, и я ничего не нашел об этом. Вот пример: type TOuterClass= class strict private type TLogger = class public /// &lt;summary&gt;adds a log en…
25 мар '14 в 18:03