Installation
Requirements
Microsoft's WindowsClient.net website provides a Getting Started page that references product downloads necessary for Windows Presentation Foundation (WPF) application development, and tutorials for new developers. For the ArcGIS API for WPF, the following items are required:
- At a minimum, install the following Microsoft products to build
ArcGIS API for WPF applications:
- Visual Studio: Visual Studio 2008 (supported for .NET Framework 3.5 developement) or Visual Studio 2010 (supported for both .NET Framework 3.5 and 4.0 developement).
- Expression Blend: Expression Blend 3 (supported for .NET Framework 3.5 development) or Expression Blend 4 (supported for .NET Framework 3.5 and 4 development).
- Other products, such as the WPF Toolkit, are not required for use with the ArcGIS API for WPF, but they are do offer significant design and development benefits.
- A basic understanding of Microsoft WPF, Visual Studio, and Expression Blend. Use the tutorials and reference materials on WindowsClient.net, MSDN, and the Expression Blend website to develop your skills.
Caution:You can install multiple versions of the ArcGIS API for WPF on the same machine, but the integrated development environment (IDE) integration features (assembly references, toolbox integration, and templates) reference the last installed version.
Installation steps
- Download the ArcGIS API for WPF setup.exe to a directory of your choice.
- Run the setup to install the ArcGIS API for WPF product. The installation includes the ArcGIS API for WPF assemblies and registers them for the Add Reference dialog box in Visual Studio. The install also adds the design-time components to Expression Blend and Visual Studio.
By default, the ArcGIS API for WPF is installed in the Program Files directory under the ESRI SDKs folder.
Tip:WPF assemblies are suported in 32-bit and 64-bit operating environments. On a 64-bit machine, the API is installed to the 64-bit Program Files directory by default.
A WPF folder contains the installed assemblies. ArcGIS API for WPF assemblies compiled for .NET 3.5 are included under the DotNet35 folder and can be used with .NET 3.5 applications built using Visual Studio 2008/2010 and Expression Blend 3/4. ArcGIS API for WPF assemblies compiled for .NET 4.0 are included under the DotNet40 folder and can be used with .NET 4.0 applications built using Visual Studio 2010 and Expression Blend 4.
The following table lists the assemblies and provides a description of their contents.
Installed assembly | Description |
|---|---|
ESRI.ArcGIS.Client.dll | Core library. Contains map, ArcGIS Service layers, graphics, geometry, and symbol components. Also contains common workflow tasks that support query, find, identify, and geospatial and geoprocessing operations. |
ESRI.ArcGIS.Client.Behaviors.dll | Contains a set of behaviors and actions that enable element-defined interactivity with a map and its contents. |
ESRI.ArcGIS.Client.Bing.dll | Adds support for using Bing layers and services. |
ESRI.ArcGIS.Client.Toolkit.dll | Contains a set of common controls for navigating and interacting with the map, such as a Toolbar, Navigation controls, and a MapTips control; and editing feature layers, such as the EditorWidget and TemplatePicker. Source available on CodePlex: http://esrisilverlight.codeplex.com |
ESRI.ArcGIS.Client.Toolkit.DataSources.dll | Contains a set of layer types that support some common data sources, such as GeoRSS, OpenStreetMap, and Web Map Service (WMS). Source available on CodePlex: http://esrisilverlight.codeplex.com |
Getting started with the API
To get started in Visual Studio 2010, see the Getting started.
To get started in Expression Blend 4, see the Getting Started with Expression Blend.