sharpmap

项目地址： https://github.com/SharpMap/SharpMap

官方文档： https://github.com/SharpMap/SharpMap/wiki

NuGet： SharpMap、SharpMap.UI、SharpMap.Extensions、SharpMap.Web、SharpMap.Layers.BruTile

最新版本： 1.2.0（截至 2026-10，NuGet；发布于 2021-03，仓库未归档但维护低频）

许可证： LGPL-2.1-or-later

概述

SharpMap 提供：

• 数据源：Shapefile、PostGIS、SQL Server Spatial、Oracle Spatial、SQLite/SpatiaLite、WMS、WFS、TileSource（OSM/Bing）
• 图层模型：VectorLayer、LabelLayer、TileLayer、WmsLayer
• 样式：VectorStyle、LabelStyle、按属性主题样式
• 坐标变换：通过 ProjNet
• 几何：基于 NetTopologySuite
• 渲染：System.Drawing 位图 / WMS 服务输出
• UI 控件：WinForms MapBox

注意：SharpMap 核心库目标框架为 netstandard2.0，而 WinForms 控件包 SharpMap.UI 仅支持 .NET Framework 4.7.2；仓库未归档但维护低频。新项目建议改用 Mapsui。

---

安装

方式一：dotnet CLI

dotnet add package SharpMap                 # 核心（netstandard2.0）
dotnet add package SharpMap.UI              # WinForms MapBox 控件（.NET Framework 4.7.2）
dotnet add package SharpMap.Extensions      # 扩展数据源（PostGIS、OGR、SpatiaLite 等）
dotnet add package SharpMap.Layers.BruTile  # 在线瓦片图层 TileAsyncLayer（依赖 BruTile 2.1.2）
dotnet add package SharpMap.Web             # ASP.NET WMS 服务
dotnet add package ProjNet4GeoAPI           # 坐标变换（实现 GeoAPI 接口；ProjNet 2.x 与 SharpMap 1.2 类型不兼容）

方式二：手写 csproj 的 PackageReference

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>WinExe</OutputType>
    <TargetFramework>net472</TargetFramework>   <!-- SharpMap.UI 只有 .NET Framework 4.7.2 -->
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="SharpMap" Version="1.2.0" />
    <PackageReference Include="SharpMap.UI" Version="1.2.0" />
    <PackageReference Include="SharpMap.Layers.BruTile" Version="1.2.0" />
  </ItemGroup>
</Project>

验证

dotnet --version        # 确认 SDK 可用
dotnet restore          # 能还原 SharpMap 1.2.0 即包解析成功
dotnet build            # 编译通过仅代表能构建，渲染结果仍需出图检查

dotnet restore 通常伴随 NU1902/NU1903/NU1904 漏洞告警（SharpMap 1.2.0 发布于 2021-03，传递依赖较旧），这是已知状态，不要当成安装失败。