WebFeatureLayer.AddAsync (.NET)

Este método agrega una nueva capa de entidades web con una consulta de filtrado opcional. Se dibujarán las entidades resultantes dentro del área del proyecto. Si la capa web que se va a agregar es segura, se le pedirá al usuario que introduzca las credenciales requeridas por el portal.

Declaración

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

Parámetros

Tipo	Nombre	Descripción	Requerido
Documento	doc	Documento de AutoCAD sobre el que se va a actuar.	obligatorio
cadena	url	URL de una capa de entidades web válida para agregar al dibujo.	obligatorio
cadena	definitionExpression	Expresión de cláusula WHERE para limitar las entidades de la capa por valores de atributo. La sintaxis de la cláusula WHERE viene determinada por los datos de origen.	opcional
cadena	branchName	Nombre de la versión en rama disponible en la capa de entidades web.	opcional

Devoluciones

Tipo	Descripción
(bool Success, ICollection<string> WebFeatureLayerNames)	Tupla nominal en la que el primer valor es el valor de Success y el segundo es el valor de WebFeatureLayerNames. El valor de Success es un valor booleano que especifica si las capas de entidades web se han agregado correctamente. El valor de WebFeatureLayerNames es un conjunto de nombres de capas de entidades web agregadas.

Observaciones sobre las condiciones de error

Este método puede generar una excepción o devolver null si un parámetro no es válido.

Ejemplo 1

Imprima el resultado correcto de agregar todas las capas de entidades web de PoolPermits sin ninguna consulta de filtrado.

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

Ejemplo 2

Imprima el resultado correcto de agregar las entidades y la capa de entidades web USA_States_Generalized donde el valor de campo STATE_NAME comienza con la letra 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
*/

Ejemplo 3

Imprima el resultado correcto de agregar la rama editor01.triangle de la capa de entidades web de 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
*/

Consulte también

MapLayer.AddAsync: método de .NET que agrega una capa de imágenes o mapas al dibujo actual utilizando las propiedades de servicio especificadas.

WebLayer.AddAsync: método de ,NET que agrega una nueva capa de mapa, capa de imágenes o una capa de entidades web al dibujo utilizando la URL especificada.

DocFeatureLayer.Add: método de ,NET que agrega una definición de capa de entidades de documento local al dibujo de AutoCAD.

esri_webfeaturelayer_add: función de AutoSLIP que agrega una nueva capa de entidades web con una consulta de filtrado opcional.