Skip To Content

MapLayer.AddAsync (.NET)

La méthode MapLayer.AddAsync ajoute une couche de carte ou d’imagerie au dessin actif à l’aide des propriétés du service spécifié. La couche utilisera le système de coordonnées actif du dessin auquel elle a été ajoutée. Si la couche est ajoutée à un dessin ne contenant aucun système de coordonnées, le dessin hérite de celui de la couche. Cette méthode renvoie le numéro d’index de la couche ajoutée, qui est utilisé pour identifier la couche de carte ou d’imagerie dans d’autres méthodes telles que MapLayer.Get.

Déclaration

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

Paramètres

TypeNomDescriptionRequis

Document

doc

Document AutoCAD sur lequel intervenir.

required

chaîne

url

Chemin de couche de carte ou d’imagerie ArcGIS valide.

required

entier

transparency

Pourcentage de transparence d’image à appliquer à la carte (les valeurs sont 0-99, zéro est opaque).

facultatif (la valeur par défaut est 30)

Retours

TypeDescription

int?

Numéro d’index de la nouvelle couche de carte ou d’imagerie.

Remarques sur les conditions d’erreur

Si un paramètre n’est pas valide, cette méthode peut générer une exception ou renvoyer null.

Exemple

Ajouter la couche de carte à partir de l’URL donnée avec une transparence de 70 % et afficher son numéro d’index.

// 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
*/

Voir aussi

MapLayer.Set : méthode .NET qui modifie les propriétés d’une couche de carte ou d’imagerie existante dans le dessin à l’aide des propriétés du service spécifié.

esri_maplayer_add : fonction AutoLISP qui ajoute une couche de carte ou d’imagerie au dessin actif à l’aide des propriétés du service spécifié.

esri_maplayer_addasync : fonction AutoLISP qui ajoute une couche de carte ou d’imagerie au dessin actif à l’aide des propriétés du service spécifié de manière asynchrone.