C#如何实现一个简单的Web服务器 C# HttpListener类的使用

来源:这里教程网 时间:2026-02-21 17:31:31 作者:

在C#中实现一个简单的Web服务器,可以使用.NET Framework自带的 HttpListener 类。它不需要依赖IIS,能够监听指定的HTTP请求并返回响应内容,非常适合开发轻量级本地服务或调试用途。

1. 启用和配置 HttpListener

要使用 HttpListener,首先需要创建实例,添加监听的URL前缀,并启动监听器。

注意:需要管理员权限运行程序,且URL前缀需通过 netsh 命令注册(Windows系统)。

示例代码:

using System;
using System.Net;
<p>class SimpleWebServer
{
private HttpListener _listener;</p><pre class="brush:php;toolbar:false;">public void Start(string prefix)
{
    if (!HttpListener.IsSupported)
    {
        Console.WriteLine("当前系统不支持 HttpListener");
        return;
    }
    _listener = new HttpListener();
    _listener.Prefixes.Add(prefix); // 例如:https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8e/
    _listener.Start();
    Console.WriteLine($"服务器已启动,监听地址:{prefix}");
    Listen();
}
private async void Listen()
{
    while (_listener.IsListening)
    {
        var context = await _listener.GetContextAsync();
        HandleRequest(context);
    }
}

}

2. 处理HTTP请求

每个请求由 HttpListenerContext 表示,包含请求(HttpRequest)和响应(HttpResponse)对象。

你可以读取请求方法、路径、查询参数等,并写入响应内容。

示例处理逻辑:

private void HandleRequest(HttpListenerContext context)
{
    var request = context.Request;
    var response = context.Response;
<pre class="brush:php;toolbar:false;">string responseString = $@"
    <html>
    <body>
        <h2>Hello from C# Web Server!</h2>
        <p>请求路径:{request.Url.PathAndQuery}</p>
        <p>请求方法:{request.HttpMethod}</p><div class="aritcle_card flexRow">
                                                        <div class="artcardd flexRow">
                                                                <a class="aritcle_card_img" href="/ai/1915" title="Summarizer"><img
                                                                                src="https://www.herecours.com/d/file/efpub/2026/21-21/20260221135800179302.jpg" alt="Summarizer"  onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
                                                                <div class="aritcle_card_info flexColumn">
                                                                        <a href="/ai/1915" title="Summarizer">Summarizer</a>
                                                                        <p>基于 AI 的文本段落摘要生成器</p>
                                                                </div>
                                                                <a href="/ai/1915" title="Summarizer" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
                                                        </div>
                                                </div>
        <p>客户端IP:{request.RemoteEndPoint}</p>
    </body>
    </html>";
byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
response.ContentLength64 = buffer.Length;
response.ContentType = "text/html; charset=utf-8";
response.OutputStream.Write(buffer, 0, buffer.Length);
response.Close();

}

3. 注册URL权限(Windows 必须)

首次使用指定端口时,系统可能拒绝访问。你需要以管理员身份运行命令提示符,执行以下命令:

netsh http add urlacl url=https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8e/ user=everyone

完成后,你的程序才能绑定到该地址。如果想监听所有IP,可用:

netsh http add urlacl url=http://*:8080/ user=everyone

不再使用时可删除注册:

netsh http delete urlacl url=https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8e/

4. 完整运行示例

将所有部分组合起来:

static void Main(string[] args)
{
    var server = new SimpleWebServer();
    server.Start("https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8e/");
<pre class="brush:php;toolbar:false;">Console.WriteLine("按任意键停止服务器...");
Console.ReadKey();
if (server._listener?.IsListening == true)
    server._listener.Stop();

}

运行后打开浏览器访问 https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8e,即可看到返回的HTML页面。

基本上就这些。你可以在 HandleRequest 中加入路由判断、静态文件返回、POST数据解析等功能,逐步扩展成更实用的小型服务端应用。

相关推荐

热文推荐