Метод MapLayer.AddAsync добавляет слой карты или слой изображений к текущему чертежу, используя указанные свойства сервиса. Слой будет использовать текущую систему координат чертежа, к которому он был добавлен. Если слой добавляется к чертежу, не имеющему системы координат, чертеж унаследует ее у слоя. Этот метод возвращает номер индекса добавленного слоя, который используется для идентификации слоя карты или слоя изображений в других методах, таких как MapLayer.Get.
Декларация
public async Task<int?> Esri.ArcGISForAutoCAD.MapLayer.AddAsync(Document doc, string url, int transparency = 30)
Параметры
| Тип | Имя | Описание | Обязательный |
|---|---|---|---|
Документ | doc | Документ AutoCAD, на основании которого следует действовать. | required |
string | url | Допустимый путь к слою карты или изображений ArcGIS. | required |
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, которая асинхронно добавляет слой карты или изображений в текущий чертеж с использованием указанных свойств сервиса.