C#一点也不会,看到这个作业的时候很懵,什么窗体之类的连怎么开始都不知道,这个作业从两眼一抹黑入手的,根本不知道如何下手。后来看到前辈们的教程才会了一点,不过仍用了很长时间才理解具体的结构,代码也全是复制的。到现在把6个作业全做完了也不会也,只知道了大概的用法结构框架,代码的大概意思,但自己写根本写不出来。写这篇教程有几个目的,一是回顾复习一下,二是大概的熟悉一下代码,争取可以模棱两可的自己会写,三是写非常详细的过程,希望可以帮助到后来者,不再因为犯常识性的错误浪费大量的时间。
先说一下运行环境,VS2019,ArcGIS10.8,ArcObjectsSDKNet。
一、作业要求
- 加载MapDocument,并获取其包含的Map。
- 获取当前选中Map所包含的Layer。
- 显示选中Layer的属性信息。
二、作业过程
1.新建Windows窗体应用
2.窗体布局
点击窗体设计窗口
打开工具箱,工具箱如果空白的话,右键单击空白区域,点击全部显示。
下面是这次作业需要用到的控件
根据以下窗体进行布局,把左边的控件拖动到相应位置,再调整大小即可(ToolbarControl不是作业要求。)有兴趣实现的可参考ArcGIS Engine入门教程_第四章_创建Engine应用程序 - GIS知乎-新一代GIS问答社区 (geoscene.cn)
3.引用的类库
引用的方法是右键单击引用-添加引用,在扩展里找。
我可能引用多了。有的引用可能没必要。不过这种多了总比少了好。
如果不添加引用,会出现类似于下方的报错。
补充一下以下类似问题的解决方法
Shift选中所有的引用的类库,把属性表的嵌入互操作类型改为False。
4.编写代码
代码的注释,我是用文心一言生成的,对了解代码的意思很有帮助,尽管我还是不会自己写。
注意不要直接复制代码,要在这个页面中双击相应的控件,它会自动跳转到以下页面Form.cs。在它新生成的代码内粘贴代码。不然到时候无法运行出相应功能。我的个人理解是因为如果不双击窗体上的控件,无法在对应的Form.Designer.cs内自动生成对应的代码。所以无法与窗体关联。
如果要删除上面方框里的代码,也要把对应Form.Designer.cs里的代码删除,不然会报错。直接点击报错信息跳转就可以。
另外可以在属性表里更改控件的名称。可以在(Name)中用有意义的英文表示。改(Name)后,若之前双击过控件,需要修改之前的代码。需要注意控件名称,我们的控件命名不一样,直接复制代码无法运行。大致了解把对应控件改为自己控件(Name)的才可以运行。
a.Form.cs
引入的命名空间
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
using ESRI.ArcGIS.esriSystem;
using ESRI.ArcGIS.Carto;//用来应用下面代码中的 IMapDocument,IMap,ILayer
using ESRI.ArcGIS.Controls;
using ESRI.ArcGIS.SystemUI;
代码
namespace EX01
{
public partial class Form1 : Form
{
public Form1()
{
//ESRI.ArcGIS.RuntimeManager.Bind(ESRI.ArcGIS.ProductCode.EngineOrDesktop);//engine控件的使用需加入此行
InitializeComponent();
}
private void Form1_Load(object sender, EventArgs e)//双击点击窗体生成。若无此代码,不会显示窗体内容
{
}
#region //文件打开 1、加载MapDocument,并获取其包含的Map。
private void LoadButton_Click_1(object sender, EventArgs e)
{
OpenFileDialog OFD = new OpenFileDialog();//创建一个新的OpenFileDialog类(也就是打开文件的对话框控件),并命名为ODF
OFD.Title = "打开地图文档文件";//设置对话框控件的对话框名字为"打开地图文档文件",就是对话框的左上角的名字
OFD.Filter = "地图文档(*.mxd)|*.mxd";//在对话框中的文件类型中,筛选掉除了*.mxd为后缀名的文件,(这样在对话框中打开的文件夹中就只有*.mxd为后缀的文件了)
if (OFD.ShowDialog() == DialogResult.OK)//检查地图文件是否有效,有效就继续执行if下面的语句块
{
string filePath = OFD.FileName;//将选择的文件的路径赋予新创建的filePath字符串中
if (axMapControl1.CheckMxFile(filePath))// CheckMxFile用来判断地址是否有效,同理有效执行if下面的语句块
{
axMapControl1.LoadMxFile(filePath, 0, Type.Missing);//使用axMapControl1.LoadMxFile来加载filePath路径中的文件(即mxd地图文件),代码是依次访问各个地图,并将地图显示在axMapControl中。
IMapDocument pMapDocument = new MapDocumentClass(); // 这里新建一个MapDocumentClass对象,用来存储地图文件信息
pMapDocument.Open(filePath, null); // 打开地图文件,将文件路径传入pMapDocument对象中
for (int i = 0; i <= pMapDocument.MapCount - 1; i++)//循环遍历地图文件中的所有地图
{
axMapControl1.Map = pMapDocument.get_Map(i);//将pMapDocument中的地图获取到axMapControl1中,以得到显示
MapcomboBox.Items.Add(axMapControl1.Map.Name);//这里将获取到的地图名字,添加到MapcomboBox1里显示
}
axMapControl1.Refresh();//刷新一下axMapControl1窗口
axMapControl1.Extent = axMapControl1.FullExtent;//将获取到的地图全局显示在axMapControl1中
}
else
{
MessageBox.Show("无法打开!" + filePath + "不是有效的文档");//如果文件路径无效,弹出一个文本为"无法打开!" + filePath + "不是有效的文档"的窗口
}
}
}
#endregion
#region 下拉框MapcomboBox读入地图文件中所含的地图名字,且所选图层变化时读取地图文件地图信息
private void MapcomboBox_SelectedIndexChanged(object sender, EventArgs e)
{
string filePath = axMapControl1.DocumentFilename; // 获取AxMapControl1控件当前打开的地图文件路径
int i = MapcomboBox.SelectedIndex; // 从MapcomboBox下拉框中获取已选择的地图索引,并将其赋值给自定义变量i
IMapDocument pMapDocument = new MapDocumentClass(); // 创建一个新的MapDocumentClass对象,命名为pMapDocument
pMapDocument.Open(filePath, null); // 使用已获取的文件路径打开地图文件,并将打开的地图文件赋值给pMapDocument对象
axMapControl1.Map = pMapDocument.get_Map(i); // 根据MapcomboBox下拉框中所选择的地图索引,从pMapDocument对象中获取相应的地图,并将其赋值给axMapControl1的Map属性
IMap pMap = axMapControl1.Map;//将当前选择的地图赋值给pMap变量,以便下面获取图层到LayerslistBox中
axMapControl1.Extent = axMapControl1.FullExtent;//将地图设置为全空间铺满,这样axMapControl1中在选择相应地图后将会缩放到全控件显示状态
LayerslistBox.Items.Clear();//在获取新的图层信息前先在LayerslistBox中清空之前的图层信息
for (int j = 0; j <= pMap.LayerCount - 1; j++) // 遍历pMap中的所有图层,并将每个图层的索引、名称等信息添加到LayerslistBox中
{
ILayer pLayer = pMap.get_Layer(j);//获取索引为j的图层
LayerslistBox.Items.Add(pLayer.Name);//获取当前获取图层的名字添加到LayerslistBox中
}
//第一幅地图中 Kauai and Niihau为栅格地图,所以用UID方法第一个不能完全加载
bool showtips = pMap.get_Layer(0).ShowTips;//获取第一个图层的显示信息,并将其赋值给showtips变量
MinScaletextBox.Text = pMap.get_Layer(0).MaximumScale.ToString();//获取第一个图层的最大比例尺值,并将其转化为字符串后赋值给MinScaletextBox文本框
MaxsScaletextBox.Text = pMap.get_Layer(0).MinimumScale.ToString(); // 获取第一个图层的最小比例尺值,并将其转化为字符串后赋值给MaxsScaletextBox文本框
// 如果第一个图层的显示信息为真(即showtips等于ture),则将MaptipsontextBox的文本设置为"Yes";否则设置为"No"
//第一个图层的显示信息的bool值==ture, MaptipsontextBox.Text显示Yes,否则显示No
if (showtips.ToString() == "ture")
MaptipsontextBox.Text = "Yes";
else
MaptipsontextBox.Text = "No"; ;
}
#endregion
#region CloseButton清空的功能实现
private void CloseButton_Click(object sender, EventArgs e)//点击CloseButton后,清空所有控件中的信息
{
axMapControl1.ClearLayers(); //清空地图控件中的所有图层
axMapControl1.Refresh(); //刷新地图控件,以显示新添加的图层或根据需要进行更新
MapcomboBox.Items.Clear(); //清空MapcomboBox下拉框中的所有选项
LayerslistBox.Items.Clear(); //清空LayerslistBox列表框中的所有选项
MinScaletextBox.Clear(); //清空MinScaletextBox文本框中的内容
MaxsScaletextBox.Clear();//清空MaxsScaletextBox文本框中的内容
MaptipsontextBox.Clear();//清空MaptipsontextBox文本框中的内容
}
#endregion
#region 在LayerslistBox中所选的图层变化时变化 下面各个textBox的文本显示为相应的值
private void LayerslistBox_SelectedIndexChanged(object sender, EventArgs e)//当LayerslistBox的选定索引改变时触发此事件,下面的代码用于更新各个TextBox的文本以反映所选中图层的信息。
{
LayerslistBox.SelectionMode = SelectionMode.One;//设置LayerslistBox中只能单选
int i = LayerslistBox.SelectedIndex;//将LayerslistBox中所选择的图层的引索值赋予i,以方便下面读取图层的相关信息(ShowTips,MaximumScale,MinimumScale)
IMap pMap = axMapControl1.Map;//用IMap创建一个将axMapControl1中的地图,赋予新创建的pMa
if (i < 0) return;//这里是为了防止异常报错,如果i为-1,即没选择LayerslistBox中的选项(一般此类空值,程序默认设为-1)
bool ShowTips = pMap.get_Layer(i).ShowTips; //获取索引为i的图层的ShowTips属性值
MinScaletextBox.Text = pMap.get_Layer(i).MaximumScale.ToString(); //获取索引为i的图层的MaximumScale属性值,并将其转化为字符串后赋值给MinScaletextBox文本框
MaxsScaletextBox.Text = pMap.get_Layer(i).MinimumScale.ToString();//获取索引为i的图层的MinimumScale属性值,并将其转化为字符串后赋值给MaxsScaletextBox文本框
if (ShowTips.ToString() == "ture")//如果ShowTips为真(即ture),则将MaptipsontextBox的文本设置为"Yes";否则设置为"No"
MaptipsontextBox.Text = "Yes";
else
MaptipsontextBox.Text = "No";
ILayer pLayer = pMap.get_Layer(i);//获取索引为i的图层,并将其赋值给pLayer变量,以备后续使用
}
#endregion
private void axLicenseControl1_Enter(object sender, EventArgs e)//该代码为了呈现地图,无此代码,Arcgis相应的控件不会被触发
{
// 当用户在界面上选择或聚焦到控件时, 事件会被触发,然后该事件处理器(即你提供的空方法)会被调用。通常情况下,你可以在这个事件处理器内部编写代码,定义在控件进入时你想要执行的操作。axLicenseControl1Enter
//但在这个代码示例中,该事件处理器是空的,也就是说在控件进入时,并没有定义任何具体的操作或逻辑。如果这个事件对你的应用程序并不重要,可以保留它为空,或者根据需要添加相关操作逻辑。axLicenseControl1
}
}
}
b.Program.cs
引入的命名空间
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using System.Windows.Forms;
using ESRI.ArcGIS;
using ESRI.ArcGIS.esriSystem;
代码
namespace EX01
{
static class Program
{
/// <summary>
/// 应用程序的主入口点。
/// </summary>
[STAThread]
static void Main()
{
ESRI.ArcGIS.RuntimeManager.Bind(ESRI.ArcGIS.ProductCode.EngineOrDesktop);//需加,不然无法正常显示地图
Application.EnableVisualStyles(); //engine控件的使用需加入此行
Application.SetCompatibleTextRenderingDefault(false);
Application.Run(new Form1());
}
}
}
三、作业成果
- 加载MapDocument,并获取其包含的Map。
- 获取当前选中Map所包含的Layer。
- 显示选中Layer的属性信息。