Wenn Sie daran interessiert sind, Referenzkommentare zu Ihrem XML-Code hinzuzufügen, verwenden Sie dieses schrittweise beschriebene Tutorial. Sie können in nur fünf Minuten lernen, wie Sie diese Funktion ausführen. Der Prozess ist zwar leicht abzuschließen, Sie sollten jedoch zunächst einige Grundlagen zu XML-Kommentaren und deren Nützlichkeit kennen, bevor Sie beginnen.
Warum XML-Kommentare nützlich sind
Kommentare in XML sind nahezu identisch mit Kommentaren in HTML, da beide dieselbe Syntax haben. Mithilfe von Kommentaren können Sie den Code verstehen, den Sie vor Jahren geschrieben haben. Es kann auch einem anderen Entwickler helfen, der den von Ihnen entwickelten Code überprüft, um zu verstehen, was Sie geschrieben haben. Kurz gesagt, bieten diese Kommentare einen Kontext für den Code.
Mit Kommentaren können Sie leicht eine Notiz hinterlassen oder einen Teil eines XML-Codes vorübergehend entfernen. Auch wenn XML als "selbstbeschreibende Daten" konzipiert wurde, müssen Sie gelegentlich einen XML-Kommentar hinterlassen.
Fertig machen
Kommentar-Tags bestehen aus zwei Teilen: dem Teil, der den Kommentar beginnt, und dem Teil, das ihn beendet. Fügen Sie zunächst den ersten Teil des Kommentartags hinzu
Beachten Sie beim Hinzufügen von Referenzkommentaren zu Ihrem XML-Code, dass diese nicht ganz oben in Ihrem Dokument stehen dürfen. In XML kann nur die XML-Deklaration an erster Stelle stehen:
Wie bereits erwähnt, dürfen Kommentare nicht ineinander geschachtelt werden. Sie müssen Ihren ersten Kommentar schließen, bevor Sie einen zweiten öffnen. Kommentare können auch nicht innerhalb von Tags auftreten, z. Verwenden Sie die beiden Bindestriche (-) niemals am Anfang und am Ende Ihrer Kommentare. Alles in Kommentaren ist für den XML-Parser praktisch unsichtbar. Seien Sie also sehr vorsichtig, dass das, was bleibt, noch gültig und wohlgeformt ist. Wenn Sie noch Fragen zum Hinzufügen von Referenzkommentaren zu XML-Code haben, möchten Sie möglicherweise ein Buch lesen, um einen detaillierten Überblick über die Funktionsweise des Prozesses zu erhalten. Bücher wie "C # 5.0 Programmer's Reference" von Rod Stephens kann sich als hilfreich erweisen. Nützliche Tipps
Einpacken