MapLayer.AddAsync (.NET)

MapLayer.AddAsync 方法将使用指定服务属性将地图或影像图层添加至当前工程图。 此图层将使用其添加到的工程图的当前坐标系。 如果将此图层添加到不含坐标系的工程图，那么该工程图将从图层中继承坐标系。 此方法将返回已添加图层的索引编号，该索引编号用于在其他方法（如 MapLayer.Get）中标识地图或影像图层。

声明

public async Task<int?> Esri.ArcGISForAutoCAD.MapLayer.AddAsync(Document doc, string url, int transparency = 30)

参数

类型	名称	描述	必填
文档	doc	要进行操作的 AutoCAD 文档。	必填
string	url	ArcGIS 地图或影像图层的有效路径。	必填
int	transparency	已应用于地图的图像透明度百分比（值为 0-99，0 表示不透明）。	可选（默认值为 30）

返回

类型	描述
int?	新地图或影像图层的索引编号。

错误条件备注

如果参数无效，则此方法可能会抛出异常或者返回 null。

示例

通过给定 URL 添加透明度为 70% 的地图图层，并打印其索引编号。

// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;
var url = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Water_Network/MapServer";

// Add the map layer
var mapLayerId = await Esri.ArcGISForAutoCAD.MapLayer.AddAsync(doc, url, 70);

// Print the index number of the map layer
doc.Editor.WriteMessage(mapLayerId.ToString());

/* Example output 
1
*/

另请参阅

MapLayer.Set - 此 .NET 方法通过指定服务属性来修改工程图中现有地图或影像图层的属性。

esri_maplayer_add - 此 AutoLISP 函数使用指定服务属性将地图或影像图层添加至当前工程图。

esri_maplayer_addasync - 此 AutoLISP 函数使用指定服务属性，以异步方式将地图或影像图层添加至当前工程图。