Kod açıklamaları - // ve /*. */

  • Makale

C# iki farklı açıklama türünü destekler. Tek satırlı açıklamalar, bu kod satırının sonunda başlayıp // biter. Çok satırlı açıklamalar ile /* başlar ve ile */biter. Aşağıdaki kod, her birinin bir örneğini gösterir:

// This is a single line comment.

/* This could be a summary of all the
   code that's in this class.
   You might add multiple paragraphs, or links to pages
   like https://video2.skills-academy.com/dotnet/csharp.
   
   You could even include emojis. This example is 🔥
   Then, when you're done, close with
   */

Çok satırlı açıklama, kod satırına metin eklemek için de kullanılabilir. Bu açıklamaların açık bir kapatma karakteri olduğundan, açıklamadan sonra daha fazla yürütülebilir kod ekleyebilirsiniz:

public static int Add(int left, int right)
{
    return left /* first operand */ + right /* second operand */;
}

Tek satırlı açıklama, yürütülebilir koddan sonra aynı satırda görüntülenebilir. Açıklama, metin satırının sonunda sona erer:

return source++; // increment the source.

Bazı açıklamalar üç eğik çizgiyle başlar: ///. Üç eğik çizgi açıklamaları XML belge açıklamalarıdır. Derleyici, insan belgeleri oluşturmak için bunları okur. Üç eğik çizgi açıklamaları bölümündeki XML belgesi açıklamaları hakkında daha fazla bilgi edinebilirsiniz.