Die Methode MapLayer.AddAsync fügt der aktuellen Zeichnung unter Verwendung der angegebenen Service-Eigenschaften einen Karten- oder Bilddaten-Layer hinzu. Der Layer verwendet das aktuelle Koordinatensystem der Zeichnung, der er hinzugefügt wurde. Wenn der Layer einer Zeichnung hinzugefügt wird, die kein Koordinatensystem enthält, übernimmt die Zeichnung das Koordinatensystem vom Layer. Diese Methode gibt die Indexnummer des hinzugefügten Layers zurück, der zur Identifizierung des Karten- oder Bilddaten-Layers in anderen Methoden wie MapLayer.Get verwendet wird.
Deklaration
public async Task<int?> Esri.ArcGISForAutoCAD.MapLayer.AddAsync(Document doc, string url, int transparency = 30)
Parameter
| Typ | Name | Beschreibung | Erforderlich |
|---|---|---|---|
Dokument | doc | Das AutoCAD-Dokument, das bearbeitet werden soll. | Erforderlich |
Zeichenfolge | url | Ein gültiger Pfad zu einem Karten- oder Bilddaten-Layer von ArcGIS. | Erforderlich |
Int | transparency | Der Prozentsatz der Bildtransparenz, der auf die Karte angewendet werden soll (Werte zwischen 0 und 99: 0 ist undurchsichtig). | Optional (Standardwert ist 30) |
Rückgaben
| Typ | Beschreibung |
|---|---|
Int? | Die Indexnummer des neuen Karten- oder Bilddaten-Layers. |
Anmerkungen zu Fehlerbedingungen
Diese Methode kann eine Ausnahme auslösen oder null zurückgeben, wenn ein Parameter ungültig ist.
Beispiel
Hinzufügen eines Karten-Layers aus der angegebenen URL mit einer Transparenz von 70 Prozent und Ausgeben seiner Indexnummer.// 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
*/
Weitere Informationen
MapLayer.Set: Eine .NET-Methode, die die Eigenschaften eines vorhandenen Karten- oder Bilddaten-Layers in der Zeichnung mit den angegebenen Service-Eigenschaften ändert.
esri_maplayer_add: Eine AutoLISP-Funktion, die der aktuellen Zeichnung mithilfe der angegebenen Service-Eigenschaften einen Karten- oder Bilddaten-Layer hinzufügt.
esri_maplayer_addasync: Eine AutoLISP-Funktion, die der aktuellen Zeichnung asynchron einen Karten- oder Bilddaten-Layer unter Verwendung der angegebenen Service-Eigenschaften hinzufügt.