C# 文件註解的 XML 標記


分類

建立時間: 2024年2月10日 03:20
更新時間: 2024年2月10日 03:24

說明

我會使用文件式的註解主要是因為 Visual Studio 之類的工具會為文件註解中使用的許多常見 XML 元素提供 IntelliSense,當然還有統一的註解規範等等的好處,本篇將紀錄一些我比較常用的註解技巧筆記。

br

如果你想換行,使用 <br/> 即可。

/// <summary>
/// 使用速度左右移動
/// </summary>
/// <param name="direction">
/// 移動方向<br/>
/// -1 向左<br/>
/// 0 靜止<br/>
/// 1 向右
/// </param>
public void MoveByDirection(float direction)
{
    // 略
}

param

param 就是參數的意思,用來描述參數

/// <summary>
/// 使用位移差左右移動
/// </summary>
/// <param name="delta">位移差</param>
public void MoveByDelta(float delta)
{
    // 略
}

summary

在 Visual Studio Code 中,在方法或成員等等的正上方打 /// 就會跳出一段 /// <summary> 標籤的註解,用來描述功能、型態等等的資訊。

/// <summary>
/// 使用位移差左右移動
/// </summary>
/// <param name="delta">位移差</param>
public void MoveByDelta(float delta)
{
    // 略
}

參考

觀看次數: 549
c#commentcsharpxml註解
按讚追蹤 Enjoy 軟體 Facebook 粉絲專頁
每週分享資訊技術

一杯咖啡的力量,勝過千言萬語的感謝。

支持我一杯咖啡,讓我繼續創作優質內容,與您分享更多知識與樂趣!