Einbetten von Intellisense Xml-Dokumentation in Assembly?

Question

Ich habe eine Assembly mit sehr gründlicher XML-basierter Dokumentation, die über Sandcastle verwendet wird, um die Hilfedateien für das Produkt zu generieren. Wir verwenden auch die XML-Ausgabedateien zum Bereitstellen von Intellisense in Visual Studio, wenn Programmierer die Assembly offensichtlich verwenden.

Um dies zu tun, haben wir anscheinend sowohl den Benutzer mit der Assembly ("assembly.dll") als auch mit der Dokumentation ("assembly.xml") versorgt.

Ist es irgendwie möglich, die Dokumentation in die Assembly einzubetten, sodass wir nur die einzelne Assembly-Datei bereitstellen müssen und Visual Studio die Informationen extrahieren könnte? Vielleicht eingebettet als Ressource oder so?

Answer 1

Leider müssen Sie beides liefern, da Visual Studio nur XML-Dokumente für Intellisense betrachten kann.

Answer 2

Fehle ich etwas? Ich sage immer wie gewohnt (mit 3 Schrägstrichen oder 3 Häkchen (vb)), benutze die eingebauten XML-Tags und wenn ich die Assembly verwende, bekomme ich den Intellisense - ich benutze selten eine externe XML-Datei.

Answer 3

Wenn Sie nach C: \ Windows \ Microsoft.NET \ Framework \ v2.0.50727 suchen, werden Sie feststellen, dass alle .net-Assemblys, auf die Sie in Ihren Anwendungen verweisen, die XML-Dateien verwenden. Visual Studio stellt nur dann Intellisense für Assemblys bereit, wenn die XML-Datei vorhanden ist. Wenn Sie beispielsweise Visual Studio schließen, dann die Datei System.Drawing.xml entfernen und dann VS erneut öffnen, sollte für diese Assembly kein Intellisense vorhanden sein. Sie müssten dann VS schließen, es zurück kopieren und dann VS wieder öffnen, damit das Intellisense wieder funktioniert.