What is the Web Application Developer Framework?
//什么是应用程序开发框架
The ArcGIS Web Application Developer Framework (ADF) for the Microsoft .NET Framework enables you to integrate GIS data and capabilities into your Web applications. The ADF includes a set of Web controls, classes, frameworks and APIs that you抣l use to build your Web applications. To get started, you can use Manager, an administrative Web application included with ArcGIS Server and ArcIMS, to step through a comprehensive Web application designer to generate a predesigned Web site. Alternatively, you can start building your Web application in Visual Studio with the Web Mapping Application template, which offers basic map display, navigation, and interactive capabilities. You can also use the Web controls directly to create a Web site from scratch or develop your own specialized（指定的） application in a style that conforms（符合） to your existing Web site.
翻译：微软.NET框架下的ADF能够使你将GIS的数据以及GIS的功能集成到你的WEB应用程序中，ADF包括一系列的Web空间、类、架构，和一些API（应用程序编程接口），这些东西能够让你创建自己的Web应用程序，刚起步的时候，你可以使用一个包含在ArcGIS服务以及ArcIMS服务中的一个网络应用管理者，去创建一个预定义的网站，或者你可以在Visual Studio里面的地图应用程序模板来创建自己应用程序，这些模板包括一些基本的地图展示导航以及交互的能力。你也可以使用一些网站工具直接将一些碎片拼接起来创建一个网站，或者也可以开发一个与你现存的网站风格一致的专用的应用程序。
The diagram（图表） below highlights the primary components and their basic relationships in the Web ADF. There are five distinct sections to consider: Web controls, Web ADF JavaScript Library, Task framework, Common Data Source API, and Web ADF graphics and core classes. All sections work in conjunction with one another. Note that most of the Web ADF components reside solely on the Web server. At runtime some client-side support content, such as Web ADF JavaScript libraries, will be loaded by the browser. A set of data sources supported out-of-the-box by the Web ADF are included for reference, but are not required for the Web ADF to be utilized（利用）. Depending on the data source, Web ADF JavaScript may be able to take advantage of browser technologies to interact directly with data source content, such as accessing a map image available via a public virtual directory. External data sources supported by the Web ADF out-of-the-box are included in gray at the bottom of the diagram. These data sources are not installed by the Web ADF and are only included to show the relationships with Web ADF components. In general, the Web ADF does not require the use of a specific data source. It can be installed and utilized on its own.
翻译：下面的图表包含了一些主要的组件以及这些组件在WebADF中的基本关系。这里有5个不同部分要考虑，网络控件，JavaScript库，任务框架，通用数据源接口，以及Web ADF 制图和一些核心的类。所有的部分就是相互结合一起工作的。请注意：所有的Web ADF 组件都是独立存在于Web 服务器上的。在运行的时候，一些客户端支持的组件，比如javascript类库将会在浏览器端加载。一些外部的可以被Web ADF支持的数据源被当做引用添加到应用程序中，但是这些对于Web ADF的使用并不是必须的。根据数据源的情况，Web ADF脚本可能能够利用浏览器技术与数据源内容进行直接的交互。被Web ADF支持的外部数据包含在图表底部的灰色部分里面。这些数据源不是被Web ADF所安装的，仅仅是用来展示和Web ADF组件之间的关系的。一般来说，Web ADF没有被要求使用特殊格式的数据源。她可以安装和使用自己
。
A set of assemblies are included with the Web ADF which contain tangible components associated with each section. The following diagram highlights the standard nomenclature（命名系统） for Web ADF assemblies（集合） that will be discussed in this help system.
翻译：一些附带于Web ADF的集合在每一个章节都包含可视化的组件，接下来的图表强调的这些集合的命名系统将会在里面的帮助系统里面讨论。
Web Controls //网络控件
The Web ADF includes a set of AJAX-enabled Web controls built on ASP .NET AJAX technologies. The Web controls utilize（利用） a set of JavaScript libraries, termed the Web ADF JavaScript Library, to process asynchronous interaction between browser and Web application components as well as remote resources. The Web ADF JavaScript Library provides a public API for Web ADF developers to enhance（极高，加强） Web applications by leveraging browser capabilities（能力）.
Web ADF 包括一系列基于.NET AJAX技术的Web 控件。Web 组件利用一系列被称作Web ADF JavaScript 类库的JavaScript库类来处理浏览器和Web 应用程序组件之间以及Web和远程资源之间的交互。Web JavaScripte 类库为Web ADF开发者提供了一个公共的API（应用程序接口），通过浏览器的的能力来加强Web 应用程序。
Web ADF controls support two
Web ADF 组件支持两种类型的AJAX模型：ASP.NET 2.0 回调函数和ASP.NET AJAX partial类型。客户端浏览器和服务器端的Web应用程序之间的状态的维持是依靠Web ADF的回调结果。 回调结果可以被创建和管理并且被设计成利用Web ADF JavaScript类库来处理浏览器内容的动态更新。
The Web ADF includes a public JavaScript API packaged in a JavaScript Library. The Web ADF JavaScript Library is built on the ASP.NET AJAX JavaScript Library and provides a comprehensive client-side framework which can be used to interact with Web ADF controls and components in a scriptable environment. Web ADF JavaScript is designed to enhance Web ADF applications by leveraging browser technologies to support client-server synchronization and pure browser interactivity. The library is available for use once a Web ADF control resides in the page. It is not designed to be used outside of the Web ADF.
Web ADF 包括一个公共的JAVASCRIPT API接口，他封装在一个javascript类库里面。Web ADF javascript 类库基于ASP.NET JAJAX javascript类库并且提供一个综合的在**环境下可以被用来和Web ADF控件以及组件交互的客户端架构。Web ADF javascript类库被设计利用浏览器技术来加强Web ADF 应用程序来支持客户端和浏览器端的**。一旦一个Web ADF 控件在网页上创建，这个类库就可以被使用。但是这个类库在Web ADF框架外部是不能使用的。
The Web ADF Task Framework is an extensible architecture by which a developer can integrate and deploy custom functionality as "Web tasks" within a Web ADF application. In general, a "Web task" is a Web control that encapsulates a set of related actions to generate results. It is a modular component that can be distributed and "plugged into" Web ADF applications via Visual Studio or the ArcGIS Manager application. The task framework provides the ability to effectively integrate a custom Web task into the Web ADF and Manager. Task framework interfaces and classes are included in the ESRI.ArcGIS.ADF.Web.UI.WebControls.dll assembly. Implementations of the task framework are included out-of-the-box with the Web ADF as task controls in the ESRI.ArcGIS.ADF.Tasks.dll and ESRI.ArcGIS.ADF.ArcGISServer.Editor.dll (EditorTask control only) assemblies.
Web ADF 任务框架 是一个***，利用它开发者可以集成和部署类似于网络任务的自定义功能到一个Web ADF 应用程序，一般来说，一个网络任务就是一个网络控件触发一系列相互联系的动作从而产生一个结果。一个独立的组件可以通过Visual Studio或者ArcGIS管理程序添加或者部署到Web ADF应用程序。task framework 可以实现高效集成一个自定义的web 任务到Web ADF和管理者。 Task framework 接口和类都包含在ESRI.ArcGIS.ADF.Web.UI.WebControls动态链接库了。
Common Data Source API
The Web ADF is designed to support data from multiple sources, including ArcGIS Server, ArcIMS, and Microsoft Virtual Earth services. The multi-source architecture allows you to integrate and interact with data from different sources at the same time, in the same application. To accomplish（达到，完成） this, the Web ADF needs a common framework in which data sources can be integrated with Web ADF components. This framework is the Common Data Source API, or in short, the Common API.
Web ADF被设计为支持来自多种数据源格式的数据，包括：ArcGIS Server，ArcIMS还有微软的虚拟地图服务。这种多数据源的支持能够让你在同一个时间、同一个程序内和来来自于不同格式数据源的数据进行集成、交互。为了达到这个目的，Web ADF需要一个公共的框架，在这个框架里面数据源可以被整合到Web ADF 组件中，这种框架就是通用数据源API(应用程序编程接口),或者简单的说就是通用API.
The Common API consists of a set of classes and interfaces in the ESRI.ArcGIS.ADF.Web.DataSources.dll assembly. These classes and interfaces make up the generic framework that Web ADF controls use to interact with different data sources in a common way (thus "Common" API). To utilize a data source as a resource within the Web ADF, the data source must provide an implementation of the Common API generic framework. The capabilities of the data source will dictate（规定、要求） the breadth of implementation. A set of data sources are supported out-of-the-box including ArcGIS Server, ArcIMS, Microsoft Virtual Earth, ArcWeb, OGC\WMS, and Web ADF graphics datasets. Each Common API implementation（落实、履行） is contained within a separate assembly（议会、集合） included with the Web ADF.
公共API包含了 一系列的类和接口，他们都封装在ESRI.ArcGIS.ADF.Web.DataSources.dll
类库组件里面。这些类和接口让框架类使得能够使用一个公用的方法和不同的数据源进行交互。为了在WEB ADF下将数据源作为一个资源来利用，那个数据源必须体提供一个通用的API框架的实施。数据源的性能将会规定其执行的广度。一系列的数据源将会在外部支持，比如：ArcGIS Server，ArcIMS,微软的虚拟地球，ArcWeb，OGC\WMS，和Web ADF 图形数据集。每一个通用的API的实施都包含在一个和Web ADF一起的独立的集合，
Some data sources are built on（3：是建立在） an explicit（详细的、明确的） programming interface used in the Common API implementation（落实、实施）. These are known as data source specific（特定的） APIs. For example, the Common API implementation of Arc GIS Server uses components in the Arc GIS Server library ESRI.ArcGIS.ADF.ArcGISServer.dll. This library leverages（力量、影响） the Arc GIS Server SOAP API to work with Arc GIS Server services via a Local or Internet connection. Note, data source specific APIs can be utilized on their own, without Web ADF controls or Common API implementation classes.
一些数据源是建立在公用API实施中使用的一个详细的编程接口。这些被认为是数据源特定的API。例如：ArcGIS Server的通用API实施中使用的是ArcGIS Server类库中使用的组件。这个类库类库影响着和ArcGIS SERVer通过本地或者网络连接一共工作的ArcGIS SOAP API 。请注意：数据源指定的API在没有Web ADF控件或者通用API实施类的时候也是可以被她自己利用，
A set of connection libraries are also included with the Web ADF to support Local connections to ArcGIS Server and TCP or HTTP connections to ArcIMS.
一系列连接的类库和Web ADF同样被包含在内，支持本地的ArcGIS Server和TCP的连接，以及ArcIMS上的HTTP连接。
Web ADF Graphics and Core Classes
Different sources of data can be combined and utilized in a common way (Common API) in the Web ADF. As a result, the Web ADF includes a set of components designed to support and enhance working with multiple resources in the Web-tier. Most of these components reside in the ESRI.ArcGIS.ADF.Web.dll assembly.
在Web ADF框架中不同的数据源可以被整合在一起使用一个通用的方式来利用。这样的结果就是，Web ADF包含了一系列的组件，这些组件被设计成支持或者加强使得可以同多种数据源一起工作。大所述的这类组件都被封装在ESRI.ArcGIS.ADF.Web.DLL里面。
In general, the Web ADF must support some of the basic capabilities of a data source or service. For example, it maintains a graphics dataset, which extends an ADO.NET Dataset to include spatial properties. The graphics dataset can contain a collection of Web ADF graphics layers which enhance（提高，增强） the ADO.NET DataTable and emulate feature class properties. The Web ADF includes a set of geometry types, renderers and symbols to manage and display graphic elements in Web ADF graphics layers. Since Web ADF graphics capabilities are managed in the Web-tier and an Common API implementation is provided, they can be integrated and utilized as map resources. Web ADF graphics provide a pure（纯理论的，完全的） Web ADF dataset type to manage selected features, dynamic data, and custom feature data sources.
一般来说，Web ADF必须支持一个数据源或者服务的一些基本的操作。比如：她维持着一个几何图形数据集，这个数据集扩展了ADO.NET数据集来包含特定的属性。这个图形数据集可以包含一个集合图层的集合，她增强了ADO.NET数据表并模仿了要素类的属性。WebADF 包含了一系列的的几何类型、符号来管理和显示几何要素在Web ADF图层上。因为Web ADF图形的操作在web-tier上管理以及一个公用的API实施的提供，他们可以被当成地图资源来集成和利用。Web ADF 图形提供了一个完全的Web ADF数据集类型来管理被选择的要素，动态数据，和一些自定义的的要素数据源。
Components of the Web ADF rely on（依赖） the Web ADF graphics and core classes to do work and interact with one another. The Map control needs to maintain a spatial reference and define display settings for a map resource to generate a map image. A task control may use task results to display graphics on a map with Web ADF graphics layers. A developer may use the generic interfaces of the Common API to execute a query using a spatial filter composed of Web ADF geometry. In addition, a set of Converter classes are included in the Web ADF to provide convenient methods for converting between client, Web ADF and data source specific data types. In a true consolidation（企业合并，巩固，加强，联合） environment such as the Web ADF, managing the translation of information between application tiers and source types is essential（比不可少的） to maximizing usability.
Web ADF的组件依赖于那些 Web ADF图形和核心类来和另外一个组件工作和交互。地图控件需要为一个地图源维持一个空间参考系和定义一个显示设置来产生一个地图图像。
一个任务控件可以通过WebADF图层图层将任务结果展示在地图上。一个开发者可能会使用通用API的一些常用接口来执行一些含有特殊过滤条件的的查询。另外，一系列的转换类也包含在Web ADF框架内，提供客户，Web ADF，和特殊类型数据源之间的转换方法。 在一个联合的环境下，比如：Web ADF，管理应用程序和数据类型之间的信息转换对于最大化利用数据是必不可少。