Skip To Content

WebFeatureLayer.AddAsync (.NET)

Cette méthode ajoute une nouvelle couche d’entités Web avec une requête de filtrage facultative. Les entités obtenues au sein de la zone du projet seront dessinées. Si la couche Web qui est ajoutée est sécurisée, l’utilisateur sera invité à saisir les informations de connexion requises pour se connecter au portail.

Déclaration

public async Task<(bool Success, ICollection<string> WebFeatureLayerNames)> Esri.ArcGISForAutoCAD.WebFeatureLayer.AddAsync(Document doc, string url, string definitionExpression = "", string branchName = "")

Paramètres

TypeNomDescriptionRequis

Document

doc

Document AutoCAD sur lequel intervenir.

required

chaîne

url

URL d’une couche d’entités Web valide à ajouter au dessin.

required

chaîne

definitionExpression

Expression basée sur une clause WHERE permettant de limiter les entités de la couche selon des valeurs attributaires. La syntaxe de la clause WHERE est déterminée par les données source.

facultatif

chaîne

branchName

Nom de la version de branche disponible sur la couche d’entités Web.

facultatif

Retours

TypeDescription

(bool Success, ICollection<chaîne> WebFeatureLayerNames)

Tuple nommé dans lequel la première valeur correspond à la valeur Success et la deuxième valeur à la valeur WebFeatureLayerNames. La valeur Success est une valeur booléenne qui indique si la ou les couches d’entités Web ont été ajoutées. La valeur WebFeatureLayerNames est un ensemble de noms de couches d’entités Web ajoutés.

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 1

Afficher l’ajout de toutes les couches d’entités Web PoolPermits sans aucune requête de filtrage.

// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;
var url = "http://sampleserver6.arcgisonline.com/arcgis/rest/services/PoolPermits/FeatureServer";

// Add the web feature layers
var success = await Esri.ArcGISForAutoCAD.WebFeatureLayer.AddAsync(doc, url);

// Print the web feature layer names
if (success.Success == true)
{
  foreach (var name in success.WebFeatureLayerNames)
  {
    doc.Editor.WriteMessage("\n" + name);
  }
}

/* Example output 
No_Permit
Has_Permit
*/

Exemple 2

Afficher l’ajout de la couche d’entités Web USA_States_Generalized et des entités où la valeur du champ STATE_NAME commence par la lettre N.

// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;
var url = "https://esri.maps.arcgis.com/home/item.html?id=8c2d6d7df8fa4142b0a1211c8dd66903";
var definitionExpression = "STATE_NAME LIKE \'N%\'";

// Add the web feature layer
var success = await Esri.ArcGISForAutoCAD.WebFeatureLayer.AddAsync(doc, url, definitionExpression);

// Print the web feature layer name
if (success.Success == true)
{
  doc.Editor.WriteMessage(success.WebFeatureLayerNames.First());
}

/* Example output 
USA_States_Generalized
*/

Exemple 3

Afficher l’ajout de la branche editor01.triangle de la couche d’entités Web Damage_To_Commercial_Buildings.

// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;
var url = "https://sampleserver7.arcgisonline.com/server/rest/services/DamageAssessment/FeatureServer";
var branchName = "editor01.triangle";

// Add the web feature layer
var success = await Esri.ArcGISForAutoCAD.WebFeatureLayer.AddAsync(doc, url, "", branchName);

// Print the web feature layer name
if (success.Success == true)
{
  doc.Editor.WriteMessage(success.WebFeatureLayerNames.First());
}

/* Example output 
Damage_To_Commercial_Buildings
*/

Voir aussi

MapLayer.AddAsync : méthode .NET qui ajoute une couche de carte ou d’imagerie au dessin actif à l’aide des propriétés du service spécifié.

WebLayer.AddAsync : méthode .NET qui ajoute une nouvelle couche de carte, d’imagerie ou d’entités Web au dessin à l’aide de l’URL spécifiée.

DocFeatureLayer.Add : méthode .NET qui ajoute une définition de couche d’entités de document au dessin AutoCAD.

esri_webfeaturelayer_add : fonction AutoLISP qui ajoute une nouvelle couche d’entités Web avec une requête de filtrage facultative.