如何在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,否则会触发类型加载异常
- 若需加载正式的Bing Maps底图,需为Map控件的
常见兼容提醒:你使用的1.0.0.0版本Bing Maps控件已进入长期不维护状态,新版Visual Studio对该程序集的设计器拖放支持存在已知缺陷,生产环境中优先选择纯代码方式初始化地图控件,可大幅减少设计器兼容问题。
内容的提问来源于stack exchange,提问作者B. Clay Shannon-B. Crow Raven
相关产品推荐
相关产品推荐

