Как документировать функции в описанной технике создания DLL C ++ .Net?

Question

Итак, у нас есть метод , а здесь еще немного о создании DLL C ++ с функциями, читаемыми языками .Net, такими как C #.

Основная идея техники, которую я использую (я могу быть идеологически неправильной, но она полностью работает для меня) - вы создали проект C ++, он работал, теперь вы хотите использовать некоторые его функции из C # (например, вы сохраняете логику вC и создайте графический интерфейс в C #, поэтому в C # вы можете просто вызывать только одну основную функцию приложения ex consol C ++, превращенного в библиотеку)

Мне нравится этот так называемый старый стиль создания управляемых частей в коде C ++.

Поэтому мне интересно, как описать (документировать) функции C ++, чтобы описание было видно на C #?

Давайте рассмотрим пример (скомпилировать с: / clr: oldSyntax)

 extern "C" int _foo(int bar)
{
  return bar;
}

namespace Bar
{
  public __gc class Foo
  {
  public:
    Foo() {}

    static int foo(int bar)
    {
      return _foo(bar);
    }
  };
};

Как мне документировать нашу функцию foo?

Answer 1

Ого ... вы используете старый стиль Managed C ++ с бизнесом __gc. Вместо этого вы должны использовать C ++ / CLI, где вы скажете public ref class Foo. Затем вы можете использовать те же комментарии к документу (начиная с /// и содержащие в них XML), как в C #.

Answer 2

Вы можете создать .dll в C #, чтобы обернуть его и добавить к нему документацию.