C# UDP 點對點通訊完整實作 (UdpClient)

UDP 特性回顧

• **無連線**、不可靠、無序、無流量控制
• **低延遲、低開銷**，適合即時通訊、廣播、遊戲、串流
• **無明確客戶端/伺服器**，雙方皆可收發 (Peer-to-Peer)

核心類別：UdpClient

封裝 SocketType.Dgram, ProtocolType.Udp，提供簡化 API：Send, Receive, JoinMulticastGroup。

完整 P2P 聊天範例 (WinForms)

public partial class ChatForm : Form
{
    private UdpClient _udp;
    private IPEndPoint _remoteEp;
    private Thread _listenThread;

    public ChatForm()
    {
        InitializeComponent();
        _udp = new UdpClient(8888); // 綁定本地埠 8888
        CheckForIllegalCrossThreadCalls = false; // 簡化跨執行緒 UI (教學用，生產請用 Invoke)
    }

    private void btnSend_Click(object sender, EventArgs e)
    {
        if (!IPAddress.TryParse(txtRemoteIP.Text, out var ip)) { MessageBox.Show("IP 格式錯誤"); return; }
        _remoteEp = new IPEndPoint(ip, 8888);

        if (_listenThread == null || !_listenThread.IsAlive)
        {
            _listenThread = new Thread(Listen) { IsBackground = true };
            _listenThread.Start();
        }

        byte[] data = Encoding.UTF8.GetBytes(txtMessage.Text);
        _udp.Send(data, data.Length, _remoteEp);
        lstMessages.Items.Add($"Me: {txtMessage.Text}");
        txtMessage.Clear();
    }

    private void Listen()
    {
        try
        {
            while (true)
            {
                IPEndPoint senderEp = null;
                byte[] data = _udp.Receive(ref senderEp); // 封鎖等待
                string msg = Encoding.UTF8.GetString(data);
                lstMessages.Items.Add($"{senderEp}: {msg}");
            }
        }
        catch (ThreadAbortException) { }
        catch (Exception ex) { MessageBox.Show($"Listen error: {ex.Message}"); }
    }

    private void btnClear_Click(object sender, EventArgs e) => lstMessages.Items.Clear();

    protected override void Dispose(bool disposing)
    {
        if (disposing)
        {
            _listenThread?.Abort(); // 簡單粗暴，生產請用 CancellationToken
            _udp?.Close();
            components?.Dispose();
        }
        base.Dispose(disposing);
    }
}

UdpClient 關鍵方法

多播 (廣播) 範例

var udp = new UdpClient();
udp.JoinMulticastGroup(IPAddress.Parse("239.255.0.1")); // 組播位址
// 發送至組播位址，所有加入該組的主機皆收到
udp.Send(data, data.Length, new IPEndPoint(IPAddress.Parse("239.255.0.1"), 9999));

Socket 直接使用 UDP (進階控制)

var sock = new Socket(AddressFamily.InterNetwork, SocketType.Dgram, ProtocolType.Udp);
sock.Bind(new IPEndPoint(IPAddress.Any, 8888));
// 設定 Socket 選項
sock.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Broadcast, 1); // 允許廣播
sock.SendTo(data, new IPEndPoint(IPAddress.Broadcast, 8888)); // 發送廣播

常見問題與解決

現代非同步寫法 (TAP)

public async Task SendAsync(string message, IPEndPoint target)
{
    byte[] data = Encoding.UTF8.GetBytes(message);
    await _udp.SendAsync(data, data.Length, target);
}

public async Task ListenAsync(CancellationToken ct)
{
    while (!ct.IsCancellationRequested)
    {
        var result = await _udp.ReceiveAsync(ct);
        string msg = Encoding.UTF8.GetString(result.Buffer);
        // 更新 UI 需 Marshal 到 UI 執行緒
        this.Invoke(() => lstMessages.Items.Add($"{result.RemoteEndPoint}: {msg}"));
    }
}

UDP 適合**高即時性、可容忍少量丟失**的場景；需可靠傳輸請用 TCP 或應用層可靠協定 (KCP, QUIC)。

1. 上一篇文章： C# Tuple 型別增強：基類、型別判斷與預設建構函式
2. 下一篇文章： WinForms 動態建立 ContextMenu (右鍵選單) 完整教學

關於C#

MEF 實戰（二）：Export/Import 基礎、ImportMany 與 Lazy 延遲載入

MEF 核心在於 Export（匯出） 與 Import（匯

Visual Studio 2005 使用 GhostDoc 實現自訂 XML 註釋模板

GhostDoc 核心價值 預設熱鍵 Ctrl+S

C# 開發 WPF/Silverlight 動畫與遊戲系列教程（十八）：完美精靈之八面玲瓏（僅限 WPF）②

為何要合成大圖？ 若遊戲包含裝備、坐騎等系統，需對圖片源進行

.NET Framework 安裝失敗完整排查與解決方案 (含圖解)

前言 .NET Framework 是 Windows 應用