WebFeatureLayer.AddAsync (.NET)

このメソッドは、オプションのフィルター クエリーを使用して新しい Web フィーチャ レイヤーを追加します。 プロジェクト エリア内に生成されたフィーチャが描画されます。 追加される Web レイヤーが安全な場合、ポータルで必須となっている認証情報の入力がユーザーに求められます。

宣言

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

パラメーター

タイプ	名前	説明	必須
ドキュメント	doc	操作対象の AutoCAD ドキュメント。	必須
string	url	ドローイングに追加する有効な Web フィーチャ レイヤーの URL。	必須
string	definitionExpression	属性値によりレイヤーからのフィーチャを制限する WHERE 句の式。 WHERE 句の構文はソース データによって決まります。	オプション
string	branchName	Web フィーチャ レイヤーで使用できるブランチ バージョンの名前。	オプション

リターン

タイプ	説明
(bool Success, ICollection<string> WebFeatureLayerNames)	最初の値が Success 値、2 番目の値が WebFeatureLayerNames 値である名前付きタプル。 Success 値は、Web フィーチャ レイヤーが正常に追加されたかどうかを示すブール値です。 WebFeatureLayerNames 値は、追加された Web フィーチャ レイヤー名のコレクションです。

エラー条件に関する注記

パラメーターが無効な場合、このメソッドは例外をスローするか、null を返すことがあります。

例 1

フィルター クエリーを使用せずに、すべての PoolPermits Web フィーチャ レイヤーを追加した成果を印刷します。

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

例 2

STATE_NAME フィールド値が文字 N で始まる USA_States_Generalized Web フィーチャ レイヤーとフィーチャを追加した成果を印刷します。

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

例 3

Damage_To_Commercial_Buildings Web フィーチャ レイヤーの editor01.triangle ブランチを追加した成果を印刷します。

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

次もご参照ください。

MapLayer.AddAsync - 指定したサービス プロパティを使用して現在のドローイングにマップ レイヤーまたはイメージ レイヤーを追加する .NET メソッドです。

WebLayer.AddAsync - 指定した URL を使用してドローイングに新しいマップ レイヤー、イメージ レイヤー、または Web フィーチャ レイヤーを追加する .NET メソッドです。

DocFeatureLayer.Add - AutoCAD ドローイングにドキュメント フィーチャ レイヤー定義を追加する .NET メソッドです。

esri_webfeaturelayer_add - オプションのフィルター クエリーを使用して新しい Web フィーチャ レイヤーを追加する AutoLISP 関数です。