You need to enable JavaScript to run this app. 如何在C# WinForms应用中添加Bing Maps控件
优惠活动
大模型
产品
解决方案
定价
更多

如何在C# WinForms应用中添加Bing Maps控件

WinForms环境下Bing Maps WPF控件的显示与实现方案

前期参考配置

你当前完成的程序集引用配置可参考对应截图:
引用配置示意图
已在Form1.cs中添加的引用指令为:
using Microsoft.Maps.MapControl;

一、让控件显示在WinForms工具箱的操作步骤

由于你使用的Bing Maps控件属于WPF类型,无法直接被WinForms原生工具箱识别,需按以下流程配置:

  • 右键工具箱空白区域,选择「重置工具箱」清除旧缓存的无效项
  • 再次右键工具箱空白区域,选择「选择项」,在弹出的配置窗口切换到WPF 组件标签页
    • 注意不要在「.NET Framework 组件」标签页检索,原生WPF控件仅会在WPF组件分类下展示
    • 如果列表中未检索到Map控件,点击「浏览」按钮,定位到项目已引用的Bing Maps核心DLL文件,加载完成后勾选Map控件对应的复选框,确认后即可将控件添加到工具箱
  • 从工具箱拖放Map控件到设计界面时,Visual Studio会自动生成ElementHost桥接容器的配套代码,无需手动编写承载逻辑
    注意:若使用2019及以上版本Visual Studio,对老旧版本(程序集版本1.0.0.0)的WPF控件设计器支持存在兼容问题,大概率无法在工具箱正常加载,这种场景下直接使用代码实现的稳定性更高,无需强行追求工具箱显示效果

二、通过纯代码创建Bing Maps控件的实现方法

WPF控件在WinForms中运行必须通过ElementHost类做桥接承载,具体实现流程:

  • 确认项目已补充以下必需的程序集引用:
    • WindowsFormsIntegration:提供ElementHost桥接能力
    • PresentationFramework、PresentationCore、WindowsBase:WPF运行的基础依赖程序集
    • 已完成引用的Microsoft.Maps.MapControl核心程序集
  • 在Form1类的构造函数中,InitializeComponent()方法后添加控件初始化逻辑,示例代码如下:
public Form1()
{
    InitializeComponent();

    // 初始化WinForms与WPF的桥接承载容器
    ElementHost mapContainer = new ElementHost
    {
        Dock = DockStyle.Fill // 设置容器铺满整个窗体
    };

    // 实例化Bing Maps核心控件
    Map bingMap = new Map
    {
        ZoomLevel = 10,
        // 设置地图初始中心点,示例坐标为北京核心区
        Center = new Location(39.9042, 116.4074)
    };

    // 将WPF地图控件挂载到桥接容器中
    mapContainer.Child = bingMap;

    // 将承载容器添加到窗体控件集合
    this.Controls.Add(mapContainer);
}
  • 补充运行配置说明:
    • 若需加载正式的Bing Maps底图,需为Map控件的CredentialsProvider属性配置已申请的服务Key,否则会出现底图无法渲染的问题
    • 需保证项目目标.NET Framework版本与控件的运行时版本(4.0.30319)匹配,最低要求为.NET Framework 4.0,否则会触发类型加载异常

常见兼容提醒:你使用的1.0.0.0版本Bing Maps控件已进入长期不维护状态,新版Visual Studio对该程序集的设计器拖放支持存在已知缺陷,生产环境中优先选择纯代码方式初始化地图控件,可大幅减少设计器兼容问题。


内容的提问来源于stack exchange,提问作者B. Clay Shannon-B. Crow Raven

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 12:45:03