Home
ArcGIS Pro Version: 2.9.0.32739
ArcGIS Pro SDK for .NET を使用して ArcGIS Pro を拡張します。ArcGIS Pro SDK for .NET は、アドインおよび構成によるの拡張性パターンに基づいています。 タスク非同期プログラミング（TAP）、LINQ、WPF バインディング、MVVM などの最新の .NET 機能とパターンを活用して、Pro の新しい API を使用して統合された 2D/3D アドインを作成できます。
トピック
- ArcGIS Pro 2.9
- Windows 11 (Home, Pro, Enterprise)
- Windows 10 (Home, Pro, Enterprise) (64 bit)
- Windows 8.1 (Pro, and Enterprise) (64 bit)
- Microsoft .NET Framework 4.8 Developer Pack
注： ArcGIS Pro 2.9 は、.NET Framework 4.8 で動作する最後のリリースとなります。ArcGIS Pro 3.0 では、Microsoft の最新版の .NET である .NET 6.0 がサポートされます。.NET 6.0 のサポートは、.NET Framework 4.8 のサポートを置き換えるものです。3.0 では、.NET Framework 4.8 はサポートされなくなります。これは 互換性を破る変更 です。
- Visual Studio 2019 (Professional, Enterprise, Community Editions)
- Visual Studio 2017 (Professional, Enterprise, Community Editions)
注： ArcGIS Pro 2.9 SDK は、Visual Studio 2017 および 2019 をサポートする最後のリリースです。ArcGIS Pro 3.0 SDK では、Microsoft の最新版の IDE である Visual Studio 2022 のサポートが導入されます。Visual Studio 2022 のサポートは、Visual Studio 2017 と 2019 のサポートを置き換えることになります。3.0 では、Visual Studio 2017 と 2019 はサポートされなくなります。
Newtonsoft Json
- ArcGIS Pro 2.9 では、Newtonsoft Json NuGet のバージョン 12.0.1 を使用しています。アドイン で Newtonsoft NuGet が必要な場合は、同じバージョンの Newtonsoft Json を使うことを推奨します。
CefSharp
-
ArcGIS Pro 2.9 では、CefSharp のバージョン 92.0.260 を使用しています。Pro では、CefSharp.dll, CefSharp.Core.dll, CefSharp.Wpf.dll を、"C:\Program Files\ArcGIS\Pro\bin\cef" のインストール先に配置しています。
-
ChromiumWebBrowser は、2.9 で非推奨となりました。現在、ChromiumWebBrowser コントロールをお使いの方は、代わりに WebViewBrowser を使うように変更してください。WebViewBrowser コントロール
WebView2
- ArcGIS Pro 2.9 以降、アドイン開発者は Microsoft Edge WebView2 をベースにした新しい WebViewBrowser コントロールを使用できます。ArcGIS Pro で使用されている現在の WebView2 の固定バージョン ランタイムについては、Pro の bin\WebView フォルダの WebView2 マニフェストを参照してください。
ArcGIS Pro API は、ArcGIS Pro のインストールごとにインストールされるマネージド .NET アセンブリです。.NET メタデータまたは PIA (Primary Interop Assemblies) を含む中間アセンブリは必要ありません。
API を構成する ArcGIS Pro マネージド アセンブリを、Visual Studio アドイン プロジェクトで直接参照として追加します。
パブリックAPI に含まれる ArcGIS Pro アセンブリ の完全なリストを以下に示します。各アセンブリの具体的な詳細については、オンラインの API Reference を参照してください。
Core アセンブリは {ArcGIS Pro インストールフォルダ}\bin にあります。
| アセンブリ | 説明 |
|---|---|
| ArcGIS.Core.dll | Provides CIM, Geodatabase, Geometry Utility Network API を提供します。 |
| ArcGIS.CoreHost.dll | スタンドアロンで利用するために ArcGIS.Core.dll を初期化するための Host.Initialize を提供します。 |
| ArcGIS.Desktop.Framework.dll | アドイン コントラクト、DAMLサポート、および基本クラスを含めるめのアプリケーションフレームワークを提供します。このアセンブリは、すべてのアドインによって参照される必要があります。 |
| ESRI.ArcGIS.ItemIndex.dll | カスタム アイテムを作成および操作する機能を提供します。 |
ArcGIS Pro 内の主要なサブシステムは、エクステンションと呼ばれる単位で構成されています。Extension アセンブリは、{ArcGIS Pro インストールフォルダ}\bin\Extensions フォルダ内の個々のサブフォルダにあります。 Extension サブフォルダは、例えば、Mapping, Editing, Layout などのように、それらが表す機能単位に合わせて論理的に命名されています。
| アセンブリ | 説明 |
|---|---|
| ArcGIS.Desktop.Catalog.dll | プロジェクト コンテンツ アイテム（マップ アイテム、レイアウト アイテム、スタイル アイテム、フォルダー アイテムなど）へのアクセスを提供します。 |
| ArcGIS.Desktop.Core.dll | プロジェクトを作成および管理する機能、現在のプロジェクトに関連付けられているイベントへのアクセス、およびジオプロセシングツールを実行する機能を提供します。 |
| ArcGIS.Desktop.DataReviewer.dll | プロジェクトのレビュアーの結果、セッション、およびバッチジョブを確立および管理する機能を提供します。 |
| ArcGIS.Desktop.Editing.dll | カスタム編集ツールの実装に必要な編集環境とコア編集機能へのアクセスを提供します。 |
| ArcGIS.Desktop.Extensions.dll | 他の ArcGIS Pro クラスのエクステンション メソッドを提供します。カスタム マップ ツールの基本クラスを提供します。 |
| ArcGIS.Desktop.Geoprocessing.dll | プロジェクトに保存されているジオプロセシングの履歴アイテムへのアクセスを提供します。（注：ジオプロセシングツールを実行するための ArcGIS.Desktop.Core.dll への参照を追加） |
| ArcGIS.Desktop.Layouts.dll | レイアウト上の要素を操作し、さまざまな画像形式にエクスポートするための機能を提供します。 |
| ArcGIS.Desktop.Mapping.dll | マップとレイヤーの作成、フィーチャのラベル付け、クエリ操作の実行、およびそれらを2Dまたは3Dで視覚化するための型を提供します。ラスター レイヤーを作成してラスター レンダリングをカスタマイズするためのラスター API と、スタイル、スタイル アイテム、およびシンボルを管理するための API を提供します。 |
| ArcGIS.Desktop.TaskAssistant.dll | タスク フレームワークを提供し、開発者がタスク アイテムにアクセス、開く、閉じる、またはエクスポートできるようにします。 |
| ArcGIS.Desktop.Workflow.dll | ワークフロー マネージャーのジョブとクエリを作成、構成、および実行する機能を提供します。ワークフロー マネージャー データベースから構成情報を取得する機能を提供します。 |
{ArcGIS Pro インストールフォルダ}\bin\Extensions サブフォルダには、パブリックAPI を持たないExtension アセンブリがあります。これらは現在 Esri 内部でのみ使用されています。
- ArcGIS.Desktop.Analyst3D.dll
- ArcGIS.Desktop.Aviation.dll
- ArcGIS.Desktop.BusinessAnalyst.dll
- ArcGIS.Desktop.CAD.dll
- ArcGIS.Desktop.Charts.dll
- ArcGIS.Desktop.DataEngineering.dll
- ArcGIS.Desktop.DataSourcesRaster.dll
- ArcGIS.Desktop.Defense.dll
- ArcGIS.Desktop.DefenseMapping.dll
- ArcGIS.Desktop.Editing.PushPull.dll
- ArcGIS.Desktop.FullMotionVideo.dll
- ArcGIS.Desktop.GAWizard.dll
- ArcGIS.Desktop.GeoProcessing.BDC.dll
- ArcGIS.Desktop.GeoProcessing.SAModels.dll
- ArcGIS.Desktop.Geostatistics.dll
- ArcGIS.Desktop.Indoors.dll
- ArcGIS.Desktop.Intelligence.dll
- ArcGIS.Desktop.Intelligence.Common.dll
- ArcGIS.Desktop.KnowledgeGraph.dll
- ArcGIS.Desktop.LocationReferencing.dll
- ArcGIS.Desktop.Maritime.dll
- ArcGIS.Desktop.Metadata.dll
- ArcGIS.Desktop.NetworkAnalysis.Facility.dll
- ArcGIS.Desktop.NetworkAnalysis.NetworkDiagrams.dll
- ArcGIS.Desktop.NetworkAnalysis.Transportation.dll
- ArcGIS.Desktop.Search.dll
- ArcGIS.Desktop.Sharing.dll
- ArcGIS.Desktop.TerritoryDesign.dll
- ArcGIS.Desktop.Workflow.Client.dll
注: パブリックAPI アセンブリに含まれる静的文字列リソース プロパティおよびイメージ リソースは、Esri 内部での使用のみを目的としています。サードパーティのアドインでの使用は意図していません。
ArcGIS Pro Extensions NuGet には、アドイン や 構成 のコンパイルに必要なすべての Pro API アセンブリが含まれており、従来のファイル ベースの参照に代わり、アドイン や 構成 で ArcGIS Pro アセンブリを参照する方法を提供します。
ArcGIS Pro Extensions NuGet は、次の環境のみで動作します:
- Visual Studio 2017 update 8 以上 (Professional, Enterprise, Community Editions)
- Visual StudioでのNuGet パッケージ管理形式は
PackageReferenceでなければなりません。 - Pro 2.5 の時点では、.Net のターゲット フレームワークは 4.8 に設定する必要があります。これは、2.5 より前のアドイン プロジェクトにNuget を追加する場合に重要です。
ProGuide: ArcGIS Pro Extensions NuGet
2.9 では、以下のような API の強化を利用することができます。
- レイアウト ツール アイテム テンプレートは、レイアウト内のグラフィックや、レイアウト内のマップ ビューやエレメントを追加／編集するためのレイアウト ツールを作成します。
- Table Construction Tool アイテム テンプレートは、スタンドアロンのテーブルに行を作成するためのテーブル作成ツールを作成します。
- GDB、ファイル、CAD データにアクセスするためのカタログ ウィンドウの強化。
- アプリケーション オプションへの API アクセス。
- テーブル テンプレート、テンプレート コマンド、テーブルの編集、スケッチのシンボルのカスタマイズ。
- アノテーション レイヤーやモバイルジオデータベースの DDL サポート。
- グループ化されたレイヤーやレイヤー ドキュメント（.lylx）にテーブルを追加したり、Web マップ形式で地図を保存したりすることができます。
- 行番号に “移動“ のようなテーブル コントロールの強化、テーブル ウィンドウ/ビューのオープンとカスタマイズ。
- ユーティリティー ネットワークの一部として保存されている名前付きトレース構成の取得と実行をサポートします。
- 1回のコールで複数レベルのユーティリティー ネットワーク 関連付けを横断することが可能（テレコミュニケーションなど一部のユーティリティー ネットワーク データモデルで重要）。
ArcGIS Pro API の変更点の詳細については、ArcGIS Pro API リファレンス ガイドの What's new for developers at 2.9 のトピックを参照してください。
- ArcGIS Pro 2.9 は、.NET Framework 4.8 で動作する最後のリリースとなります。ArcGIS Pro 3.0 では、Microsoft の最新版の .NET である .NET 6.0 のサポートが導入されます。.NET 6.0 のサポートは、.NET Framework 4.8 のサポートを置き換えるものです。3.0 では、.NET Framework 4.8 はサポートされなくなります。これは 互換性を破る変更 となります。
- ArcGIS Pro 2.9 SDK は、Visual Studio 2017 および 2019 をサポートする最後のリリースです。ArcGIS Pro 3.0 SDK は、Microsoft の最新版の IDE である Visual Studio 2022 のサポートを導入します。Visual Studio 2022 のサポートは、Visual Studio 2017 と 2019 のサポートを置き換えることになります。3.0 では、Visual Studio 2017 と 2019 はサポートされなくなります。
ArcGIS Pro 2.5 のリリースから、最小の .NET ターゲットは 4.8 に変更され、4.6.1 ではなくなりました。これは、開発者と開発者の作成したアドインで下記ような影響を受けます。
- 既にデプロイされている既存のアドインは、2.9 で動作し、前方互換性に変更はありません。
- 2.9 で再コンパイル（コードの変更など）された既存のアドインは、ターゲット フレームワークの最小値を 4.8 に設定しないとコンパイルできません。注：既存のアドインが何らかの理由で変更された場合は、そのアドインの Config.daml ファイルの desktopVersion 属性を、最後にコンパイルされた Pro のバージョン（この場合は 2.9）に合わせて変更する必要があります。
4.6.1 で開発されたアドインを 4.8 に移行するには、テクニカル サポートの記事 ArcGIS Pro SDK のバージョン 2.0 ～ 2.4 のアドイン ソリューションを 2.5 以降のバージョンに変換する を参照してください。
- 以前のバージョンで作成したアドインを再コンパイルする場合は、Visual Studio のプラットフォーム ターゲットを「Any CPU」から「x64」に変更することを推奨します。
- 同じく 2.8 から、Visual Studio Designer を使用してユーザー コントロール .xaml を開くと、「ファイルまたはアセンブリ名 'ArcGIS.Desktop.Framework' が読み込めませんでした。」というエラーが発生することがあります。 詳しくは、ArcGIS Pro FAQ をご参照ください。
Pro のコンセプト、ガイド、スニペット、サンプルが多数用意されており、SDK の新機能を使いこなすのに役立ちます。SDK リソースの更新内容は以下の通りですが、これらに限定されるものではありません。
- ProConcepts: Framework
- ProConcepts: COGO
- ProConcepts: Project Content and items
- ProConcepts: Editing
- ProConcepts: Layouts
- ProConcepts: Parcel Fabric
- ProConcepts: Map Authoring
- ProConcepts: Reports
- ProConcepts: Geometry
- ProGuide: Regression Testing
- Pro Community Samples と Snippets には新しいサンプルとスニペットがあります。
ArcGIS Pro SDK for .NET は、以下のいずれかのオプションを使用してダウンロードし、インストールすることができます:
詳細なインストール方法は、ProGuide: Installation and Upgrade をご参照ください。
次の表は、ダウンロードする SDK の各 .vsix ファイルの機能をまとめたものです：
| 名称 | ファイル | 機能 |
|---|---|---|
| ArcGIS Pro SDK for .NET | proapp-sdk-templates.vsix | ArcGIS Pro アドインを作成するための、プロジェクトとアイテム テンプレートのコレクション |
| ArcGIS Pro SDK for .NET (Utilities) | proapp-sdk-utilities.vsix | ArcGIS Pro アドインの作成に役立つユーティリティのコレクション |
パッケージ: proapp-sdk-templates.vsix
ArcGIS Pro SDK for .NET は次のプロジェクトとアイテム テンプレートを提供しています:
| C# | VB | 名称 |
|---|---|---|
 |
 |
ArcGIS Pro モジュール アドイン プロジェクト テンプレート |
 |
 |
ArcGIS Pro 構成管理 プロジェクト テンプレート |
 |
N/A | ArcGIS Pro Plugin プロジェクト テンプレート |
 |
N/A | ArcGIS Pro CoreHost アプリケーション プロジェクト テンプレート |
 |
 |
ArcGIS Pro のバックステージ タブ |
 |
 |
ArcGIS Pro ボタン |
 |
 |
ArcGIS Pro ボタン パレット |
 |
 |
ArcGIS Pro コンボ ボックス |
 |
 |
ArcGIS Pro 作図ツール |
|
|
ArcGIS Pro カスタム コントロール |
|
N/A | ArcGIS Pro カスタム アイテム |
|
N/A | ArcGIS Pro カスタム プロジェクト アイテム |
 |
 |
ArcGIS Pro ドッキング ウィンドウ |
|
|
|
ArcGIS Pro ドッキング ウィンドウ (ハンバーガー ボタン付き) |
 |
 |
ArcGIS Pro ドロップ ハンドラー |
 |
 |
ArcGIS Pro 埋め込み可能なコントロール |
 |
 |
ArcGIS Pro ギャラリー |
 |
 |
ArcGIS Pro インラインギャラリー |
 |
N/A | ArcGIS Pro レイアウト ツール |
 |
 |
ArcGIS Pro マップ ウィンドウの偽装 |
 |
 |
ArcGIS Pro マップ ツール |
 |
 |
ArcGIS Pro メニュー |
 |
 |
ArcGIS Pro ウィンドウ |
 |
 |
ArcGIS Pro プロパティシート |
 |
 |
ArcGIS Pro ProWindow |
 |
 |
ArcGIS Pro 分割ボタン |
 |
N/A | ArcGIS Pro Table Construction Tool |
一般的に、フレームワークの UI 要素の拡張ポイント（ボタン, ツール, メニュー, ドッキング ウィンドウなど）とアイテム テンプレートの間には 1 対 1 の対応関係があります。 対応する拡張ポイントをアドインに追加するには、関連するアイテム テンプレート を使用します。
注：さらに詳しい説明がある以下のアイテム テンプレートは、便利かもしれません。
ArcGIS Pro Framework では、2 つの仮想関数によるドラッグ&ドロップがサポートされています。それは、OnDragOver と OnDrop です。これらのメソッドの基本的な実装をアドインに追加し、カスタム ウィンドウやドッキング ウィンドウでドラッグ&ドロップの機能をサポートを開始するのに、ドロップ ハンドラー テンプレートを使用して下さい。
Excel Drop Handler サンプル
ポップアップ などの UI をカスタム マップツールに追加するには、埋め込み可能なコントロール テンプレートを使用して下さい。マップツールをアクティブにすると、もし存在する場合、関連した埋め込み可能なコントロールがアクティブなマップ ビュー上に表示されます。マップツールが非アクティブになると、埋め込み可能なコントロールは非表示になります。
ProGuide: Using Embeddable Controls
Basic Map Tool サンプル
Map Tool with OverlayControl サンプル
マップ TOC コンテンツ コントロール（カスタム コンテンツ コントロールではなく）を "使用" したい場合は、マップ ウィンドウを "偽装" する必要があります。
マップ ウィンドウの偽装でカスタム ウィンドウを実装するのに必要なコードを生成するには、このテンプレートを実行します。
ProGuide: Map Pane Impersonation
ImpersonateMapPane サンプル
パッケージ: proapp-sdk-utilities.vsix
ArcGIS Pro SDK for .NET (Utilities) は、Visual Studio 環境を拡張する次のようなユーティリティ（日本語UI: ArcGIS Pro の参照先を修正、ArcGIS Pro の DAML Id を生成）を提供します。
| 名称 | 説明 |
|---|---|
| Pro Fix References utility | ArcGIS Pro アドイン、コア ホスト、構成管理、またはプラグイン プロジェクトの壊れた参照を修正します。壊れた参照は、アドイン を他の同僚と共有したり、ArcGIS Pro アセンブリ参照がインストールした場所とは異なる場所を指しているアドインをダウンロードした場合に発生することがあります。Pro Fix References は、ソリューション内の個々のプロジェクトまたはすべてのプロジェクトで実行できます。 |
| Pro Generate DAML Ids utility | ArcGIS Pro Desktop Application Markup Language（DAML）のすべての文字列 ID を、DAML 要素タイプ（Button、Dockpane、Tool、Condition など）によって整理された静的な文字列プロパティに変換します。これにより、DAML 文字列 ID を手動で入力するのではなく、ソース コード ファイル内の Visual Studio の IntelliSense 機能を使用して ID を追加することができます。 |
ArcGIS Pro のリボンに表示されるボタンの作成方法は、ProGuide: Build your first add-in をご参照ください。
ProSnippets はArcGIS Pro アドインにすばやく挿入できるコード スニペットです。利用可能なスニペットの一覧は利用可能な ProSnippets のリスト にあります。
- ArcGIS Pro 2.9 は、.NET Framework 4.8 で動作する最後のリリースとなります。ArcGIS Pro 3.0 では、Microsoft の最新版の .NET である .NET 6.0 のサポートが導入されます。.NET 6.0 のサポートは、.NET Framework 4.8 のサポートを置き換えるものです。3.0 では、.NET Framework 4.8 はサポートされなくなります。これは 互換性を破る変更 となります。
- ArcGIS Pro 2.9 SDK は、Visual Studio 2017 および 2019 をサポートする最後のリリースです。ArcGIS Pro 3.0 SDK では、Microsoft の最新版の IDE である Visual Studio 2022 のサポートが導入されます。Visual Studio 2022 のサポートは、Visual Studio 2017 と 2019 のサポートを置き換えることになります。3.0 では、Visual Studio 2017 および 2019 はサポートされなくなります。
- ChromiumWebBrowser は 2.9 で非推奨となりました。現在、ChromiumWebBrowser コントロールを使用している場合は、代わりに WebViewBrowser を使用するように変更してください。WebViewBrowser コントロール
- ArcGIS Pro 2.8 SDK for .NET
- ArcGIS Pro 2.7 SDK for .NET
- ArcGIS Pro 2.6 SDK for .NET
- ArcGIS Pro 2.5 SDK for .NET
- ArcGIS Pro 2.4 SDK for .NET
- ArcGIS Pro 2.3 SDK for .NET
- ArcGIS Pro 2.2 SDK for .NET
- ArcGIS Pro 2.1 SDK for .NET
- ArcGIS Pro 2.0 SDK for .NET
- ArcGIS Pro 1.4 SDK for .NET
- ArcGIS Pro 1.3 SDK for .NET
- ArcGIS Pro 1.2 SDK for .NET
- ArcGIS Pro 1.1 SDK for .NET
<button...largeImage="pack://application:,,,/ArcGIS.Desktop.Resources;component/Images/<ImageNameHere>"/> 