ArcGIS API for Silverlight开发入门

时间：2023-03-09 00:26:17
ArcGIS API for Silverlight开发入门

你用上3G手机了吗？你可能会说，我就是喜欢用nokia1100，ABCDEFG跟我 都没关系。但你不能否认3G是一种趋势，最终我们每个人都会被包裹在3G网络中。1100也不是一成不变，没准哪天为了打击犯罪，会在你的1100上强制 装上GPS。GIS工作既然建立在计算机的基础上，当然也得随着IT行业与时俱进。
      
看看现在计算机应用的趋势吧。云（计算），这个东西可讲不清楚，因为云嘛，飘忽不定的。不过可以这样来看它，以后计算机网络上就有一坨（或者几坨）万能的
云，有什么需求云都可以满足我们，包括各种资源或者计算工作，就不需要在自己的机器上安装任何软件了（甚至操作系统都可以由天边那朵云来提供给你）。更具
体点，SaaS（Software as a Service），各种的网页邮件系统，google docs(一
个在线的office)都是SaaS。收发邮件登陆一个网页就行，而不需要在自己机器上安装一个软件。这就是计算机应用的一个趋势，把所有东西都做到网
上。再来看看网上的趋势：RIA（Rich
InternetApplication）。RIA简单来讲就是一个网页（网络应用），在完成基本功能的同时，会让你觉得很漂亮，操作起来很舒服，效果很
炫，而不是打开后立刻就想关掉它。其实大受欢迎的开心网（各种插件）和twitter，甚至QQ空间等，都有RIA的身影。
       好了，ArcGIS之所以在行业领先，特点之一就是它能紧跟计算机发展的趋势。ArcGIS Online就是那朵天边的浮云；JavaScript API，Flex API，Siverlight API就是ArcGIS自己RIA的三驾马车。
 
     这里还得插一句，我觉得ArcGIS
Server的主角本来是ADF，通过它我们可以完成一个无所不能的ServerGIS。但在大多数情况下，GIS都是作为特定的业务嵌入在一些MIS中
的，相比购买ADF这辆悍马来说，还是直接驾驭三套车跑的更轻快一些。
       现在看看我们的主角。其实是ArcGIS API
forSilverlight/WPF（以下专注Siverlight部分），那么Silverlight和WPF的关系如何呢？Silverlight
原来叫WPF/E，E就是Everywhere，从命名可以看出它们的关系：Silverlight是WPF的一个子集。WPF
是.NETFramework
3.0的组成部分之一，微软视其为下一代用户界面，总之很高档就是了（在Vista和Windows7中看到的大量与XP不同的界面，就是WPF的身
影）；Silverlight可以看做是WPF在浏览器里的一个外挂，用于向网络用户展示自己的强大能力，由于受限于网络环境，所以是WPF的一部分核心
功能。Siverlight的设计初衷是跨平台，跨浏览器的。
      
如果这些还是比较抽象，那么可以造一个排比句来进一步说明。之前先肯定一点，Flash现在在网络中的的主导地位。开始造句。Adobe有Flash，微
软有Silverlight；Adobe有AIR，微软有WPF；Flex有mxml，Silverlight有xaml；Adobe有
ActionScript，微软有Code-Behind（C#/VB.NET）或者JavaScript；Adobe有CS（包括
Dreamweaver，Flash，Fireworks，Photoshop，Illustrator），微软有ExpressionStudio（包
括Blend，Web，Design，Media，Encoder）。现在，能够看来Siverlight到底是何方神圣了吧？
      
最后再来说说ArcGIS这三驾马车（JavaScript API，Flex
API，SiverlightAPI）。国外有人说，随着Siverlight API的推出，与Flex
API一起，将会使JavaScriptAPI慢慢退出历史舞台，因为前两者就是为RIA而生的。但其实也不然，随着Google和Mozilla工程师
的推进，他们能够使JavaScript的执行速度提高非常多，Chrome就是例子。在这种背景下，一些非常cool的程序员会让古老的JavaScript获得重生。到底哪匹马跑得更快？别回答这种问题，赶紧挑一匹自己的马儿，快马扬鞭吧~~
       在今年的ESRI开发用户大会上，一阵鼓声过后，ESRI隆重推出了ArcGIS API for Silverlight/WPF（beta）。接下来我将把自己在学习Silverlight API中的一些经历和大家分享，与大伙共同进步。

原作者:diligentpig

原文地址:http://bbs.esrichina-bj.cn/ESRI/thread-43923-1-1.html

ArcGIS API for Silverlight开发入门（1）：Getting Started

   这一节来对Silverlight API（ArcGIS API for Silverlight，下同）的开发有个总体的认识。
        欲善其事先利其器。要做开发，第一步就得搭建环境。因为是在Siverlight基础上做开发，所以先得整理好Siverlight的开发环境。Silverlight并没有内建在VS2008中，而是作为add-on的形式附加的。在这里可以找到详细的安装步骤：
ArcGIS API for Silverlight开发入门

        说明一下，步骤1安装了Silverlight
add-on（要求有IDE的SP1补丁包）；步骤2安装的是ExpressionStudio中的ExpressionBlend，这个工具相当于可视
化的xaml编辑器，可以用来轻松的创建Silverlight程序的用户界面；步骤3中安装的是Silverlight一种非常华丽的图片处理效果，可
以参看这里的实例；步骤4包括一些可用的Silverlight控件和例子。接下来再去看看Silverlight API的要求。可以看出对于开发ArcGIS Silverlight程序来说，只有步骤1是必须的，其他都是可选的。之后需要从ESRI网站下载Silverlight API（需要免费注册一个ESRI Global账户），以备后用。
        总结一下最常见的安装步骤：1、安装VS2008；2、安装VS2008 SP1；3、安装Silverlight Tools for Visual Studio 2008 SP1。到此，就可进行Silverlight程序的开发了。关于开发环境的搭建，还可以参考yyilyzbc版主的帖子。（做Silverlight API的开发不需要在自己的机器上安装ArcGIS Server，可直接使用ArcGIS Online上的数据；但如果要添加自己的数据，当然还是需要ArcGIS Server了）
        下面就来一个Hello World吧，对于GIS来说，理所当然就是展示一张漂亮的世界地图了。具体步骤如下：
1、VS2008中，新建project，选择Silverlight Application；
2、
在出现的提示框中选择Add a new ASP.NET Web project to the solution to
hostSilverlight；（Silverlight程序与flash一样，相当于网页中的一个插件。第一个选项是将Silverlight嵌入到
一个ASP.NET网站中，第二个选项是将Silverlight嵌入到一个临时的html页面中）
3、添加Silverlight API的引用：与.NET程序开发一样，add reference（注意是在Silverlight工程上而不是ASP.NET工程上），找到从ESRI下载的API，选择添加ESRI.ArcGIS.dll；
4、打开Page.xaml，在UserControl标签中添加一句引用，在Grid标签之间添加一些代码，完成后看起来像这样：
  1. <UserControl x:Class="SilverlightApplication1.Page"
  2. xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  3. xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  4. xmlns:esri="clr-namespace:ESRI.ArcGIS;assembly=ESRI.ArcGIS"
  5. Width="400" Height="300">
  6. <Grid x:Name="LayoutRoot" Background="White">
  7. <esri:Map x:Name="mymap">
  8. <esri:Map.Layers>
  9. <esri:ArcGISTiledMapServiceLayer ID="layerworldmap"
  10. Url="http://server.arcgisonline.com/ArcGIS/rest/services/ESRI_Imagery_World_2D/MapServer" />
  11. </esri:Map.Layers>
  12. </esri:Map>
  13. </Grid>
  14. </UserControl>

复制代码

5、按F5，运行程序，就完成了我们的hello world in
GIS可以在浏览器中看到下面的画面：
ArcGIS API for Silverlight开发入门

        看到效果之后，再来对它进行理解吧。
    
   先说下Silverlight的程序的基本背景。page.xaml实际上是一个控件，相当于asp.net中的default.aspx，大部分
的工作都在这里面完成（app.xaml相当于global.asax）；上面的是xaml（读：[ig`zeml]）代码，是微软针对
wpf/silverlight的标记语言，与flex中的mxml类似。Silverlight程序中所有的布局工作都是由xaml来完成
的；Silverlight2中，VS2008可以实时对xaml的效果做预览，但是这个预览效果是只读的，对于预览中的控件也不可选；为了弥补这个缺
陷，可以用前面提到的ExpressionBlend来可视化地设计程序界面，会自动生成对应的xaml代码，使用于复杂的布局和美化工作（可参考
Silverlight中的clock例子）；再看page.xaml。usercontrol标签（页面的根元素）证明了page.xaml实际上是一
个控件类；下面的几句相当于引入了xml的特定命名空间，里面包括了我们的ESRI.ArcGIS；width和height指明了
Silverlight控件本身的尺寸，一般我们将这里的width和height属性去掉，已达到全屏的效果（你也可以试试哦）；Grid标签是布局控
件，相当于html中的表格，可以进行灵活的页面布局，xaml中常用的布局控件还有Canvas和StackPanel；每一个xaml的
Control都可以有一个x:Name属性，以便在code-behind页面中对其引用。
    
   之后是我们的主角了。Map标签（继承自xaml的Control）相当于一个Map控件，可以在其中加入图层；这里我们添加了一个
ArcGISTiledMapServiceLayer图层（在后面的文章中会专门讲到SilverlightAPI中的图层类型），对应使用的是
ArcGIS
Server发布的经过cache的服务，作为客户端的API，同JavaScript与FlexAPI一样，都是通过REST方式对资源和操作进行引用
的；对这个图层，赋予了一个ID属性，因为SilverlightAPI中的图层是从xaml中的DependencyObject继承而来，所以没有
x:Name的属性，为了方便在code-behind（与asp.net类似的托管代码）的代码中找到这个图层，便使用了ID属性；URL的内容便是
ArcGIS Online发布好的一个世界地图资源。
        到此，应该对这个例子理解的差不多了。如果还想再添加一个图层怎么办呢？没错，就是在Map标签中再添加一个layer，不过要注意的是，第一个加入的图层会显示在最下面，并且决定了整个Map控件的空间参考信息。
        大家自然会想到叠加一个自己的数据图层来看看效果，于是对Map标签内容做了修改（china是本机发布的一个中国地图）：

  1. <esri:ArcGISDynamicMapServiceLayer ID="chinamaplayer"
  2. Url="http://localhost/ArcGIS/rest/services/china/MapServer" />

复制代码

运行后却还是只有世界地图一个图层（已经确保拼写、大小写正确），怎么回事呢？来用事件帮助查找错误吧。
 
  
   Silverlight能够利用.net的一些核心库内容，包括事件。来对刚才的那个图层添加一个事
件：InitializationFailed，当图层添加失败的时候会出发这个事件。添加这个事件的处理也非常简单：在上面的图层中加入
InitializationFailed属性，会提示你生成新的eventhandler，默认回车，看上去像这样：

  1. <esri:ArcGISDynamicMapServiceLayerID="chinamaplayer"InitializationFailed="ArcGISDynamicMapServiceLayer_InitializationFailed"
  2. Url="http://localhost/ArcGIS/rest/services/china/MapServer" />

复制代码

在事件上面右键单击，Navigate to Event Handler，就会进入前面所说的code-behind页面（本例为C#），添加以下代码：

  1. private void ArcGISDynamicMapServiceLayer_InitializationFailed(object sender, EventArgs e)
  2. {
  3. ESRI.ArcGIS.Layer layer = sender as ESRI.ArcGIS.Layer;
  4. MessageBox.Show(layer.InitializationFailure.Message);
  5. }

复制代码

然后运行程序，会得到初始化图层失败的原因：
ArcGIS API for Silverlight开发入门

    
   原来，为了安全原因考虑，同flash一样，Silverlight对跨域访问也做了严格的限制。要解决这个问题，可以参考帮助中的说明，将两个
xml文件保存在网站根目录，比如C:\Inetpub\wwwroot中即可（其实保存其中一个就可以了，ArcGISOnline已经将两个xml文
件都放在了网站根目录中，所以我们可以引用上面的服务）。
        看下最后的效果吧。
ArcGIS API for Silverlight开发入门

为了更好的理解xaml和Silverlight，建议首先独立完成Silverlight帮助中的两个workthrough：hello world和clock。
原文地址:http://bbs.esrichina-bj.cn/ESRI/thread-44042-1-1.html

原作者:diligentpig

ArcGIS API for Silverlight开发入门（2）：一个基础地图实例

   这节在一个地图实例的基础上，来对Silverlight API中的一些基本概念做一个总体了解，顺便熟悉一下Silverlight的开发知识。
        点击这里，直接看效果。

ArcGIS API for Silverlight开发入门

        根据上一节的知识，可以知道这个Silverlight程序里包含了一个Map控件，并且里面至少有一个WorldImagery的图层。那么Page.xaml里的关键代码开起来应该是这样的：

  1. <Grid x:Name="LayoutRoot">
  2. <esri:Map x:Name="Map1">
  3. <esri:Map.Layers>
  4. <esri:ArcGISTiledMapServiceLayer ID="WorldImageLayer" x:Name="WorldImageLayer" Initialized="WorldImageLayer_Initialized"
  5. Url="http://services.arcgisonline.com/ArcGIS/rest/services/ESRI_Imagery_World_2D/MapServer" />
  6. </esri:Map.Layers>
  7. </esri:Map>
  8. </Grid>

复制代码

所
有的布局工作都在一个Grid中进行，给它起个名字叫LayoutRoot。Grid里面放了一个esri:Map元素（Map控件），它继承自
Silverlight的Control，所以拥有Width和Height属性，默认是Auto，自动填充整个Grid。Map.Layers是一个集
合，可以往里面添加layer，这里的layer指的是ArcGIS
Server或其他软件发布的地图服务，目前SilverlightAPI中支持的能够直接使用的有
ArcGISDynamicMapServiceLayer，ArcGISTiledMapServiceLayer，ArcGISImageServiceLayer，
分别对应ArcGIS Server发布的动态地图服务，缓存地图服务（两种Map
Service）和ImageService，这三种图层是拿来即用的，如果你想加入别的地图服务，比如WMS服务，则需要自己继承相应类型的的
Layer；此外还有GraphicsLayer，ElementLayer，SilverlightAPI特有的FeatureLayer等。这些都会
在之后的小节中讲到。强调一下，与ADF开发里MapResourceManager一样，在Map中加入的内容实际上是地图服务，但当做一个layer
处理。
        下面就对这个例子中的每一部分来做说明（与上图中的序号相对应）。

1、当地图移动时获取地图范围。
        当地图范围改变后，显示出当前地图范围的边界值。
        这部分的页面布局是这样的：

  1. <Grid x:Name="Gridright" Margin="0,15,20,0" HorizontalAlignment="Right" VerticalAlignment="Stretch">
  2. <!--extent-->
  3. <Canvas Width="215" Height="110" VerticalAlignment="Top">
  4. <Rectangle Style="{StaticResource rectBottom}" />
  5. <Rectangle Style="{StaticResource rectMiddle}" />
  6. <Rectangle Style="{StaticResource rectTop}" />
  7. <TextBlock x:Name="TBextent" Margin="20,15,15,0" Text="范围：" TextWrapping="Wrap" FontWeight="Bold" />
  8. </Canvas>
  9. </Grid>

复制代码

有
关xaml中详细的布局知识请大家参照其他例子学习，这里稍作讲解。外面的Gridright这个Grid就是页面右边1、2、3、6的父容器，之所以不
用StackPanel是因为6需要贴着页面底部，StackPanel中的元素都会flow贴到一起。三个矩形组合便构成了整体轮廓，由于它们都在一个
Canvas中，所以会产生压盖效果。最先加入的rectBottom这个矩形便是最底下的阴影效果，中间的矩形是蓝色框，最上面的矩形是白色的文字显示
区域。“{
}”里的内容在xaml中称作markupextention，StaticResource是使用在别处已经定义好的资源（resource）来对本元
素的一些属性进行自动赋值，这里用来修饰Rectangle的外观。xaml中除了StaticResource这种markupextention之外
还有Binding和TemplateBinding两种markup
extention，分别用于数据绑定（databinding）和自定义control的外观。上面的StaticResource是在
App.xaml中定义的，这样就可以在本工程的任何页面中使用，当然也可以定义为LayoutRoot这个Grid的Resource。贴出来大家一看
就明白了：

  1. <Application.Resources>
  2. <Style x:Key="rectBottom" TargetType="Rectangle">
  3. <Setter Property="RadiusX" Value="10" />
  4. <Setter Property="RadiusY" Value="10" />
  5. <Setter Property="Fill" Value="#22000000" />
  6. <Setter Property="Canvas.Left" Value="5" />
  7. <Setter Property="Canvas.Top" Value="5" />
  8. <Setter Property="Width" Value="215" />
  9. <Setter Property="Height" Value="110" />
  10. </Style>
  11. <Style x:Key="rectMiddle" TargetType="Rectangle">
  12. <Setter Property="RadiusX" Value="10" />
  13. <Setter Property="RadiusY" Value="10" />
  14. <Setter Property="Fill" Value="#775C90B2" />
  15. <Setter Property="Canvas.Left" Value="0" />
  16. <Setter Property="Canvas.Top" Value="0" />
  17. <Setter Property="Width" Value="215" />
  18. <Setter Property="Height" Value="110" />
  19. <Setter Property="Stroke" Value="Gray" />
  20. </Style>
  21. <Style x:Key="rectTop" TargetType="Rectangle">
  22. <Setter Property="RadiusX" Value="5" />
  23. <Setter Property="RadiusY" Value="5" />
  24. <Setter Property="Fill" Value="#FFFFFFFF" />
  25. <Setter Property="Canvas.Left" Value="10" />
  26. <Setter Property="Canvas.Top" Value="10" />
  27. <Setter Property="Width" Value="195" />
  28. <Setter Property="Height" Value="90" />
  29. <Setter Property="Stroke" Value="DarkGreen" />
  30. </Style>
  31. </Application.Resources>

复制代码

它们就相当于网页中的css。如果不使用StaticResource，那么三个矩形看起来应该是这样的：

  1. <Rectangle RadiusX="10" RadiusY="10" Fill="#22000000" Canvas.Left="5" Canvas.Top="5" Width="215" Height="110" />
  2. <Rectangle
    RadiusX="10" RadiusY="10" Fill="#775C90B2" Canvas.Left="0"
    Canvas.Top="0" Width="215" Height="110" Stroke="Gray" />
  3. <Rectangle
    RadiusX="5" RadiusY="5" Fill="#FFFFFFFF" Canvas.Left="10"
    Canvas.Top="10" Width="195" Height="90" Stroke="DarkGreen" />

复制代码

你猜的没错，在其他矩形框部分也使用到了这些属性。通过实践可以感受到，xaml中的布局在一般使用中比html+css的布局要简单和灵活许多。好了，继续。
 
  
   Map控件里面已经封装了一些事件来供我们使用，我们可以在需要的时候捕获它们来进行处理。如果做过ArcGIS产品的二次开发，你应该已经想到我
们要捕获的就是Map的ExtentChanged事件；而要在地图移动或者缩放的过程中也实时显示地图范围，则还要对ExtentChanging事件
做处理。细心的你可能已经发现，在上面的xaml代码中已经对世界地图这个图层的Initialized事件添加了一个
hanlder：WorldImageLayer_Initialized。当然可以像这样一样给Map的这两个事件添加handler，但这里并不这么
做，而是在世界地图图层的Initialized事件里来绑定它们（移动地图时出发ExtentChanged事件，网速过慢导致图层并未加入到Map
中，则会报错）。来看看Page.xaml.cs中的code-behind代码：

  1. private void WorldImageLayer_Initialized(object sender, EventArgs e)
  2. {
  3. Map1.ExtentChanged += new EventHandler<ESRI.ArcGIS.ExtentEventArgs>(Map1_ExtentChange);
  4. Map1.ExtentChanging += new EventHandler<ESRI.ArcGIS.ExtentEventArgs>(Map1_ExtentChange);
  5. }

复制代码

没错，把两个事件绑定到同一个handler即可。再看看Map1_ExtentChange中的代码：

  1. private void Map1_ExtentChange(object sender, ESRI.ArcGIS.ExtentEventArgs e)
  2. {
  3. TBextent.Text = string.Format("地图范围：\nMinX:{0}\nMinY:{1}\nMaxX:{2}\nMaxY:{3}",
  4. e.NewExtent.XMin, e.NewExtent.YMin, e.NewExtent.XMax, e.NewExtent.YMax);
  5. }

复制代码

很简单吧？顺便提一下，ExtentEventArgs里既然有NewExtent，当然就有OldExtent了，通过比较这两个变量就可以分析出当前进行的是放大、缩小还是平移操作了。其实还有个更简单的办法，查查看Map的Resolution属性吧。
对于Silverlight API中内容，是不是感觉很容易呢（当然你得做够xaml的功课才行）？那么赶快来看第二部分。

2、当鼠标移动时获取鼠标坐标。
        包括屏幕坐标和地图坐标。外观样式方面是这样的：

  1. <!--mouse coords-->
  2. <Canvas Width="215" Height="110" Margin="0,120,0,0" VerticalAlignment="Top">
  3. <Rectangle Style="{StaticResource rectBottom}" />
  4. <Rectangle Style="{StaticResource rectMiddle}" />
  5. <Rectangle Style="{StaticResource rectTop}" />
  6. <StackPanel Orientation="Vertical" Margin="20,15,15,0">
  7. <TextBlock x:Name="TBscreencoords"
  8. HorizontalAlignment="Left" VerticalAlignment="Center" Text="屏幕坐标：" TextWrapping="Wrap" FontWeight="Bold" />
  9. <TextBlock x:Name="TBmapcoords"
  10. HorizontalAlignment="Left" VerticalAlignment="Center" Text="地图坐标：" TextWrapping="Wrap" FontWeight="Bold" />
  11. </StackPanel>
  12. </Canvas>

复制代码

那
么接下来要捕捉那个事件呢？当然就是MouseMove啦。不过如果查看SilverlightAPI中的Map类，发现并没有这个事件。但要记住Map
是继承自xaml中的Control，Control继承自FrameworkElement,FrameworkElement继承自
UIElement，这里就有一个MouseMove事件了。所以Map控件的MouseMove是xaml中而不是Siverlight
API中的事件（当然整个SilverlightAPI都是建立在xaml基础上的）。在esri:Map标签中添加一个MouseMove事件
（MouseMove="Map1_MouseMove"），来看看code-behind代码：

  1. private void Map1_MouseMove(object sender, MouseEventArgs e)
  2. {
  3. if (Map1.Extent != null)
  4. {
  5. System.Windows.Point screenPnt = e.GetPosition(Map1);
  6. TBscreencoords.Text = string.Format("屏幕坐标：\nX：{0}，Y：{1}", screenPnt.X, screenPnt.Y);
  7. ESRI.ArcGIS.Geometry.MapPoint mapPnt = Map1.ScreenToMap(screenPnt);
  8. TBmapcoords.Text = string.Format("地图坐标：\nX：{0}\nY：{1}", Math.Round(mapPnt.X, 4), Math.Round(mapPnt.Y, 4));
  9. }
  10. }

复制代码

可
以看到Map控件提供了屏幕与地图坐标之间转换的方法，好比开发人员的一座桥梁，用来往返于Silverlight特性与地图之间，非常方便。需要说明的
是，这里GetPosition(Map1)获得的屏幕坐标是相对于Map控件的，而不是显示器的左上角。ok，继续来看第三部分。

3、Map里的动画效果。
 
  
   当地图放大和平移时都可以看到平滑的效果，这归功于Silverlight的动画功能。Map在封装完动画效果后，给了我们两个属性来对它们进行设
置：PanDuration和ZoomDuration，用于设置这两个动作持续的时间。它们都是TimeSpan类型的变量，合理的设置可以带来良好的
用户体验。看看这部分的布局：

  1. <!--map animation slider-->
  2. <Canvas Width="215" Height="130" Margin="0,240,0,0" VerticalAlignment="Top">
  3. <Rectangle Style="{StaticResource rectBottom}" Height="130" />
  4. <Rectangle Style="{StaticResource rectMiddle}" Height="130" />
  5. <Rectangle Style="{StaticResource rectTop}" Height="110" />
  6. <StackPanel Orientation="Vertical" Margin="20,15,15,0">
  7. <TextBlock HorizontalAlignment="Left" Text="设置地图缩放动作持续时间：" TextWrapping="Wrap" FontWeight="Bold" />
  8. <TextBlock x:Name="TBzoomdurationvalue" HorizontalAlignment="Left" Text="当前值：" TextWrapping="Wrap" FontWeight="Bold" />
  9. <Slider x:Name="sliderzoomanimation" Orientation="Horizontal" Minimum="0" Maximum="20" SmallChange="1"
  10. LargeChange="5" Cursor="Hand" ValueChanged="slideranimation_ValueChanged" Width="180" />
  11. <TextBlock HorizontalAlignment="Left" Text="设置地图平移动作持续时间：" TextWrapping="Wrap" FontWeight="Bold" />
  12. <TextBlock x:Name="TBpandurationvalue" HorizontalAlignment="Left" Text="当前值：" TextWrapping="Wrap" FontWeight="Bold" />
  13. <Slider x:Name="sliderpananimation" Orientation="Horizontal" Minimum="0" Maximum="20" SmallChange="1"
  14. LargeChange="5" Cursor="Hand" ValueChanged="slideranimation_ValueChanged" Width="180" />
  15. </StackPanel>
  16. </Canvas>

复制代码

主要用到了两个slider控件。再看看拖动滑块时的事件代码，为了省事，这两个事件也用了同一个handler：

  1. private void slideranimation_ValueChanged(object sender, RoutedPropertyChangedEventArgs e)
  2. {
  3. Slider s=sender as Slider;
  4. if (s.Name == "sliderzoomanimation")
  5. {
  6. Map1.ZoomDuration = new TimeSpan(0, 0, Convert.ToInt32(sliderzoomanimation.Value));
  7. TBzoomdurationvalue.Text = string.Format("当前值：{0}秒", Convert.ToInt32(sliderzoomanimation.Value));
  8. }
  9. else
  10. {
  11. Map1.PanDuration = new TimeSpan(0, 0, Convert.ToInt32(sliderpananimation.Value));
  12. TBpandurationvalue.Text = string.Format("当前值：{0}秒", Convert.ToInt32(sliderpananimation.Value));
  13. }
  14. }

复制代码

对应着地图效果，应该很容易理解。继续第四部分。

4、对地图服务可见性与动态地图服务中图层可见性的控制。
 
  
   还是要强调一下，WorldImagery和StreetMap两个能看到的地图实际上都是地图服务，当作layer加入到了Map控件中；而动态
地图服务USA中的图层Cities，Rivers，States才是与ArcMap中图层相对的概念。对于WorldImagery和
StreetMap之间的切换，主要用到了Silverlight API里Layer的
Visible属性；而动态服务中图层可见性的操作，主要是对ArcGISDynamicMapServiceLayer的VisibleLayers数组做了设置。
        StreetMap这个服务其实一开始就加入了地图（在esri:Map标签中）：

  1. <esri:ArcGISTiledMapServiceLayer ID="StreetMapLayer"
  2. Url="http://services.arcgisonline.com/ArcGIS/rest/services/ESRI_StreetMap_World_2D/MapServer" Visible="False" />

复制代码

而设置了Visible="False"。图层不可见时地图不会对它做任何处理，所以不用担心会耗费流量或加重程序负担。
        看看布局部分：

  1. <StackPanel HorizontalAlignment="Left" Margin="20,15,0,0">
  2. <Canvas x:Name="Canvasleft" Width="165" Height="90" HorizontalAlignment="Left" VerticalAlignment="Top">
  3. <Rectangle Style="{StaticResource rectBottom}" Width="165" Height="90" />
  4. <Rectangle Style="{StaticResource rectMiddle}" Fill="#7758FF00" Width="165" Height="90" />
  5. <Rectangle Style="{StaticResource rectTop}" Width="145" Height="70" />
  6. <!--change layer-->
  7. <StackPanel Margin="20,15,15,0">
  8. <TextBlock Text="切换图层:" TextWrapping="Wrap" FontWeight="Bold" />
  9. <StackPanel Orientation="Horizontal">
  10. <ToggleButton x:Name="TBimagery" Content="Imagery" Click="TBimagery_Clicked" Cursor="Hand" />
  11. <ToggleButton x:Name="TBstreetmap" Content="StreetMap" Click="TBstreetmap_Clicked" Cursor="Hand" />
  12. </StackPanel>
  13. <CheckBox
    Margin="0,5,0,0" x:Name="chkboxDynamicLayer" Content="添加一个动态图层吧"
    IsChecked="False" Click="chkboxDynamicLayer_Click" Cursor="Hand" />
  14. </StackPanel>
  15. </Canvas>
  16. </StackPanel>

复制代码

这
里使用了ToggleButton，CheckBox和RadioButton都由它派生而来。Silverlight2中的ToggleButton不
能设置Group（一个Group中自动限定同时只能有一个控件处于激活状态），不如Flex里的ToggleButton来的方便，所以code-
behind中多做了些工作。当然这里使用RadioButton也是可以的。

  1. private void TBimagery_Clicked(object sender, RoutedEventArgs e)
  2. {
  3. if (TBstreetmap.IsChecked==true)
  4. {
  5. Map1.Layers["WorldImageLayer"].Visible = true;
  6. Map1.Layers["WorldImageLayer"].Opacity = 0;
  7. TBstreetmap.IsChecked = false;
  8. Storyboard sbworldmapshow = makestoryboard("WorldImageLayer", 0, 1);
  9. Storyboard sbstreetmaphide = makestoryboard("StreetMapLayer", 1, 0);
  10. sbworldmapshow.Begin();
  11. sbstreetmaphide.Begin();
  12. hidelayername = "StreetMapLayer";
  13. timer.Begin();
  14. }
  15. TBimagery.IsChecked = true;
  16. }
  17. private void TBstreetmap_Clicked(object sender, RoutedEventArgs e)
  18. {
  19. if (TBimagery.IsChecked==true)
  20. {
  21. Map1.Layers["StreetMapLayer"].Visible = true;
  22. Map1.Layers["StreetMapLayer"].Opacity = 0;
  23. TBimagery.IsChecked = false;
  24. Storyboard sbstreetmapshow = makestoryboard("StreetMapLayer", 0, 1);
  25. Storyboard sbworldmaphide = makestoryboard("WorldImageLayer", 1, 0);
  26. sbstreetmapshow.Begin();
  27. sbworldmaphide.Begin();
  28. hidelayername = "WorldImageLayer";
  29. timer.Begin();
  30. }
  31. TBstreetmap.IsChecked = true;
  32. }
  33. private void timer_Tick(object sender, EventArgs e)
  34. {
  35. Map1.Layers[hidelayername].Visible = false;
  36. }
  37. public Storyboard makestoryboard(string layername, double from, double to)
  38. {
  39. Storyboard sb = new Storyboard();
  40. ESRI.ArcGIS.ArcGISTiledMapServiceLayer layer = Map1.Layers[layername] as ESRI.ArcGIS.ArcGISTiledMapServiceLayer;
  41. DoubleAnimation doubleAnim = new DoubleAnimation();
  42. doubleAnim.Duration = new TimeSpan(0, 0, 5);
  43. doubleAnim.From = from;
  44. doubleAnim.To = to;
  45. Storyboard.SetTarget(doubleAnim, layer);
  46. Storyboard.SetTargetProperty(doubleAnim, new PropertyPath("Opacity"));
  47. sb.Children.Add(doubleAnim);
  48. return sb;
  49. }

复制代码

当
切换两个地图服务时能够看到一个渐变的效果，这里用到了Silverlight中的动画，它们都是在StoryBoard里面进行的，以后的小节中会讲
Silverlight中的动画，这里不再废话了，有兴趣的朋友可以自己参考帮助学习。hidelayername是这个一个公用的string变量，用
来在切换的动画效果完成后设置不可见的图层Visible属性。timer也是一个StoryBoard：

  1. <Storyboard x:Name="timer" Completed="timer_Tick" Duration="0:0:5" />

复制代码

这里可以看出把StoryBoard也能巧妙的用作计时器。到了特定时间（5秒）后会自动timer_Tick函数，当然也可以使用.net中的各种timer类。
        下面是添加动态服务的部分。

  1. private void chkboxDynamicLayer_Click(object sender, RoutedEventArgs e)
  2. {
  3. if (chkboxDynamicLayer.IsChecked == true)
  4. {
  5. Map1.Layers.Add(california);
  6. Map1.ZoomTo(california.FullExtent);
  7. if (california.IsInitialized == false)
  8. {
  9. chkboxDynamicLayer.IsEnabled = false;
  10. }
  11. chkboxDynamicLayer.Content = "去掉它";
  12. SVlayers.Visibility = Visibility.Visible;
  13. }
  14. else
  15. {
  16. Map1.Layers.Remove(california);
  17. chkboxDynamicLayer.Content = "添加一个动态图层吧";
  18. SVlayers.Visibility = Visibility.Collapsed;
  19. }
  20. }
  21. private void dynamiclayer_initialized(object s, EventArgs e)
  22. {
  23. //若图层没有初始化好就移除图层，当然会报错了，所以这样做就不会了
  24. chkboxDynamicLayer.IsEnabled = true;
  25. Map1.ZoomTo(california.InitialExtent);
  26. SVlayers.Visibility = Visibility.Visible;
  27. california.ID = "layercalifornia";
  28. ESRI.ArcGIS.ArcGISDynamicMapServiceLayer dynamicServiceLayer = s as ESRI.ArcGIS.ArcGISDynamicMapServiceLayer;
  29. if (dynamicServiceLayer.VisibleLayers == null)
  30. dynamicServiceLayer.VisibleLayers = GetDefaultVisibleLayers(dynamicServiceLayer);
  31. UpdateLayerList(dynamicServiceLayer);
  32. }

复制代码

当添加了动态服务后，会自动弹出一个listbox，当然这些也都是在xaml中定义好的（加在上面的Canvas后面）：

  1. <ScrollViewer x:Name="SVlayers" Width="165" Visibility="Collapsed" Height="120">
  2. <ListBox x:Name="LayerVisibilityListBox" >
  3. <ListBox.ItemTemplate>
  4. <DataTemplate>
  5. <CheckBox Margin="2" Name="{Binding LayerIndex}" Content="{Binding LayerName}"
  6. Tag="{Binding ServiceName}" IsChecked="{Binding Visible}"
  7. ClickMode="Press" Click="chkboxToggleVilible_Click" />
  8. </DataTemplate>
  9. </ListBox.ItemTemplate>
  10. </ListBox>
  11. </ScrollViewer>

复制代码

这
里把ListBox放到了ScrollVierwer中，固定了它的高度，当内容过多时可以自动显示纵向滚动条。这里要提一下，ListBox的内容用到
了数据绑定（参考xaml中的DataBinding，有OneTime,OneWay和TwoWay三种模式，这里使用的是默认的OneWay），看起
来里面只有一个CheckBox，但它相当于一个模板，在code-behind中设置了ListBox.ItemSource之后，根据该属性的内容自
动生成多个CheckBox。代码中自定义了一个LayerListData类，它的几个属性分别与上面的CheckBox属性绑定；将一个List赋给
了ListBox.ItemSource，则会自动生成ListBox中的内容。通过一个List类型变量，来控制动态服务的可见图层。代码如下：

  1. public class LayerListData
  2. {
  3. public bool Visible { get; set; }
  4. public string ServiceName { get; set; }
  5. public string LayerName { get; set; }
  6. public int LayerIndex { get; set; }
  7. }
  8. private int[] GetDefaultVisibleLayers(ESRI.ArcGIS.ArcGISDynamicMapServiceLayer dynamicService)
  9. {
  10. List<int> visibleLayerIDList = new List<int>();
  11. ESRI.ArcGIS.LayerInfo[] layerInfoArray = dynamicService.Layers;
  12. for (int index = 0; index < layerInfoArray.Length; index++)
  13. {
  14. if (layerInfoArray[index].DefaultVisibility)
  15. visibleLayerIDList.Add(index);
  16. }
  17. return visibleLayerIDList.ToArray();
  18. }
  19. private void UpdateLayerList(ESRI.ArcGIS.ArcGISDynamicMapServiceLayer dynamicServiceLayer)
  20. {
  21. int[] visibleLayerIDs = dynamicServiceLayer.VisibleLayers;
  22. if (visibleLayerIDs == null)
  23. visibleLayerIDs = GetDefaultVisibleLayers(dynamicServiceLayer);
  24. List<LayerListData> visibleLayerList = new List<LayerListData>();
  25. ESRI.ArcGIS.LayerInfo[] layerInfoArray = dynamicServiceLayer.Layers;
  26. for (int index = 0; index < layerInfoArray.Length; index++)
  27. {
  28. visibleLayerList.Add(new LayerListData()
  29. {
  30. Visible = visibleLayerIDs.Contains(index),
  31. ServiceName = dynamicServiceLayer.ID,
  32. LayerName = layerInfoArray[index].Name,
  33. LayerIndex = index
  34. });
  35. }
  36. LayerVisibilityListBox.ItemsSource = visibleLayerList;
  37. }
  38. void chkboxToggleVilible_Click(object sender, RoutedEventArgs e)
  39. {
  40. CheckBox tickedCheckBox = sender as CheckBox;
  41. string serviceName = tickedCheckBox.Tag.ToString();
  42. bool visible = (bool)tickedCheckBox.IsChecked;
  43. int layerIndex = Int32.Parse(tickedCheckBox.Name);
  44. ESRI.ArcGIS.ArcGISDynamicMapServiceLayer dynamicServiceLayer = Map1.Layers[serviceName] as
  45. ESRI.ArcGIS.ArcGISDynamicMapServiceLayer;
  46. List<int> visibleLayerList =
  47. dynamicServiceLayer.VisibleLayers != null
  48. ? dynamicServiceLayer.VisibleLayers.ToList() : new List<int>();
  49. if (visible)
  50. {
  51. if (!visibleLayerList.Contains(layerIndex))
  52. visibleLayerList.Add(layerIndex);
  53. }
  54. else
  55. {
  56. if (visibleLayerList.Contains(layerIndex))
  57. visibleLayerList.Remove(layerIndex);
  58. }
  59. dynamicServiceLayer.VisibleLayers = visibleLayerList.ToArray();
  60. }

复制代码

5、比例尺。
        Silverlight API提供了一个ScaleBar类，可以方便的设置地图比例尺。

  1. <!--scale bar 放在LayoutRoot Grid中-->
  2. <Canvas HorizontalAlignment="Left" VerticalAlignment="Bottom" Margin="10,0,0,20">
  3. <esri:ScaleBar
    x:Name="scalebar" MapUnit="DecimalDegrees" DisplayUnit="Kilometers"
    Foreground="Black" FillColor1="White" FillColor2="Blue" />
  4. </Canvas>

复制代码

需要在初始化的时候设置scalebar的Map属性，顺便来看看整个页面的初始化工作：

  1. namespace demo_02_extendedmap
  2. {
  3. public partial class Page : UserControl
  4. {
  5. private ESRI.ArcGIS.ArcGISDynamicMapServiceLayer california = new ESRI.ArcGIS.ArcGISDynamicMapServiceLayer();
  6. private string hidelayername;
  7. public Page()
  8. {
  9. InitializeComponent();
  10. scalebar.Map = Map1;
  11. scalebarstoryboard.Begin();
  12. TBzoomdurationvalue.Text = string.Format("当前值：{0}.{1}秒", Map1.ZoomDuration.Seconds, Map1.ZoomDuration.Milliseconds);
  13. TBpandurationvalue.Text = string.Format("当前值：{0}.{1}秒", Map1.PanDuration.Seconds, Map1.PanDuration.Milliseconds);
  14. california.Url = "http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Specialty/ESRI_StatesCitiesRivers_USA/MapServer";
  15. california.Opacity = 0.5;
  16. california.Initialized += new EventHandler<EventArgs>(dynamiclayer_initialized);
  17. TBimagery.IsChecked = true;
  18. makestoryboard("WorldImageLayer", 0, 1).Begin();
  19. //切换全屏/窗口
  20. Application.Current.Host.Content.FullScreenChanged += new EventHandler(fullscreen_changed);
  21. }
  22. }
  23. }

复制代码

scalebarstoryboard是xaml里自定义的一个动画，效果见比例尺旁的单位。

6、地图相关操作。
 
  
   Map控件已经内置了一些键盘鼠标事件，但目前不能像JavascriptAPI中那样禁用这些事件。这里还用到了Silverlight程序的一
个全屏特性，其实是对Application.Current.Host.Content的一个属性做了设置。直接看代码吧：

  1. <!--operation info-->
  2. <Canvas Width="215" Height="110" Margin="0,0,0,30" VerticalAlignment="Bottom">
  3. <Rectangle Style="{StaticResource rectBottom}" />
  4. <Rectangle Style="{StaticResource rectMiddle}" Fill="#77FF0000" />
  5. <Rectangle Style="{StaticResource rectTop}" />
  6. <TextBlock Margin="20,15,15,0" TextWrapping="Wrap"
  7. Text="地图操作提示：双击放大 Shift+拖拽：放大到指定范围 Ctrl+Shift+拖拽：缩小到指定范围" />
  8. <ToggleButton
    x:Name="TBfullscreen" Content="点击切换地图全屏" HorizontalAlignment="Center"
    Canvas.Left="100" Canvas.Top="15" Height="30" Click="TBfullscreen_Click"
    />
  9. </Canvas>

复制代码

放到Gridright Grid中，

  1. private void TBfullscreen_Click(object sender, RoutedEventArgs e)
  2. {
  3. System.Windows.Interop.Content content = Application.Current.Host.Content;
  4. content.IsFullScreen=!content.IsFullScreen;
  5. }
  6. private void fullscreen_changed(object o,EventArgs e)
  7. {
  8. System.Windows.Interop.Content content=Application.Current.Host.Content;
  9. TBfullscreen.IsChecked = content.IsFullScreen;
  10. }

复制代码

7、进度条。
        最后还剩下地图中的这个进度条。利用了Map控件内置的一个Progress事件。

  1. <!--progressbar 放在LayoutRoot中-->
  2. <Grid
    HorizontalAlignment="Center" x:Name="progressGrid"
    VerticalAlignment="Center" Width="200" Height="20" Margin="5,5,5,5">
  3. <ProgressBar x:Name="MyProgressBar" Minimum="0" Maximum="100" />
  4. <TextBlock x:Name="ProgressValueTextBlock" Text="100%" HorizontalAlignment="Center" VerticalAlignment="Center" />
  5. </Grid>

复制代码

在esri:Map标签中加入一个事件：Progress="Map1_Progress",

  1. private void Map1_Progress(object sender, ESRI.ArcGIS.ProgressEventArgs e)
  2. {
  3. if (e.Progress < 100)
  4. {
  5. progressGrid.Visibility = Visibility.Visible;
  6. MyProgressBar.Value = e.Progress;
  7. ProgressValueTextBlock.Text = String.Format("正在处理 {0}%", e.Progress);
  8. }
  9. else
  10. {
  11. progressGrid.Visibility = Visibility.Collapsed;
  12. }
  13. }

复制代码

好了到此就已经讲完了整个地图功能。尽管想尽可能详细说明每段代码，便于初学的朋友学习，但也不可能面面俱到。没有讲明白的地方大家可以自己思考，查帮助。学习的过程中，不思考，无进步。
原文地址:http://bbs.esrichina-bj.cn/ESRI/thread-44365-1-1.html

ArcGIS API for Silverlight开发入门（3）：Widgets

Widgets翻译过来是小玩具。如果使用过Dojo或者ExtJS等js框架肯定会了解到这个“小玩具”也有大用处，能够在很大程度上减少我们的工作量,快速完成功能需求。能减少多大工作量呢？让我们先来，点击这里，看一个例子。

ArcGIS API for Silverlight开发入门

前两节的地图中，总感觉少点什么……对，就是一个sliderbar，有了它感觉就像汽车有了方向盘一样，能够控制方向了。那么来看看实现上面这个例子中的滑块条需要做什么工作吧。
在silverlight中创建一个UserControl，把上面sliderbar的外观和功能都封装在里面。
来看具体工作。vs中，在silverlight工程上右键单击，add，new item，选择silverlight user control，起名叫mapslider，在mapslider.xaml中填如下代码：

  1. <Grid x:Name="slidergrid" HorizontalAlignment="Left" VerticalAlignment="Center" Background="Azure" Margin="20">
  2. <StackPanel Orientation="Vertical">
  3. <Button x:Name="btnzoomin" Content="+" Click="btnzoomin_Click" />
  4. <Slider x:Name="sliderLOD"
    Orientation="Vertical"  Height="200" SmallChange="1"
    LargeChange="1"  Minimum="0" Cursor="Hand"
    ValueChanged="slider1_ValueChanged" />
  5. <Button x:Name="btnzoomout" Content="-" Click="btnzoomout_Click" />
  6. </StackPanel>
  7. </Grid>

复制代码

上
面这些就是滑块条的外观，接下来看功能部分。大致思路是在mapslider类中设置一个公共属性Map，就是需要操作的地图了，但这个属性不是
ESRI.ArcGIS.Map，而是另一个自定义类。为什么要这么做？因为这个自定义类需要实现INotifyPropertyChanged接口，当
我们把自己的Map控件作为mapslider的属性赋值的时候，这个Map需要做另外一些工作。看代码吧，不太明白的话就要加强对
silverlight中data binding的学习。在mapslider.xaml.cs页面中填入一下代码：

  1. using System;
  2. using System.Collections.Generic;
  3. using System.Linq;
  4. using System.Net;
  5. using System.Windows;
  6. using System.Windows.Controls;
  7. using System.Windows.Documents;
  8. using System.Windows.Input;
  9. using System.Windows.Media;
  10. using System.Windows.Media.Animation;
  11. using System.Windows.Shapes;
  12. using System.ComponentModel;
  13. namespace customcontrol
  14. {
  15. public partial class mapslider : UserControl
  16. {
  17. private mymap map = new mymap();
  18. public ESRI.ArcGIS.Map Map
  19. {
  20. get
  21. {
  22. return map.Map;
  23. }
  24. set
  25. {
  26. map.Map=value;
  27. if (map.Map != null)
  28. {
  29. Map.ExtentChanged += new EventHandler<ESRI.ArcGIS.ExtentEventArgs>(map_ExtentChanged);
  30. Map.SnapToLevels = true;
  31. ((ESRI.ArcGIS.ArcGISTiledMapServiceLayer)Map.Layers[0]).Initialized
    += new EventHandler<EventArgs>(layer0_initialized);
  32. }
  33. }
  34. }
  35. private void layer0_initialized(object o,EventArgs e)
  36. {
  37. sliderLOD.Maximum = ((ESRI.ArcGIS.ArcGISTiledMapServiceLayer)Map.Layers[0]).TileInfo.Lods.Length - 1;
  38. }
  39. public mapslider()
  40. {
  41. InitializeComponent();
  42. }
  43. private void slider1_ValueChanged(object sender, RoutedPropertyChangedEventArgs<double> e)
  44. {
  45. if (map.Map!=null)
  46. {
  47. Map.ZoomToResolution(((ESRI.ArcGIS.ArcGISTiledMapServiceLayer)Map.Layers[0]).TileInfo.Lods[Convert.ToInt32(e.NewValue)].Resolution);
  48. }
  49. }
  50. private void map_ExtentChanged(object o, ESRI.ArcGIS.ExtentEventArgs e)
  51. {
  52. ESRI.ArcGIS.ArcGISTiledMapServiceLayer layer = Map.Layers[0] as ESRI.ArcGIS.ArcGISTiledMapServiceLayer;
  53. int i;
  54. for (i = 0; i < layer.TileInfo.Lods.Length; i++)
  55. {
  56. if (Map.Resolution == layer.TileInfo.Lods[i].Resolution)
  57. break;
  58. }
  59. sliderLOD.Value = i;
  60. }
  61. private void btnzoomin_Click(object sender, RoutedEventArgs e)
  62. {
  63. sliderLOD.Value += 1;
  64. }
  65. private void btnzoomout_Click(object sender, RoutedEventArgs e)
  66. {
  67. sliderLOD.Value -= 1;
  68. }
  69. }
  70. //执行了这个接口后，当在主页面page.xaml.cs中给Map赋值的时候，就能返到set语句中，以便执行绑定事件的代码
  71. public class mymap:INotifyPropertyChanged
  72. {
  73. private ESRI.ArcGIS.Map map;
  74. public ESRI.ArcGIS.Map Map
  75. {
  76. get{return map;}
  77. set
  78. {
  79. map = value;
  80. if (PropertyChanged!=null)
  81. {
  82. PropertyChanged(this, new PropertyChangedEventArgs("Map"));
  83. }
  84. }
  85. }
  86. public event PropertyChangedEventHandler PropertyChanged;
  87. }
  88. }

复制代码

做完封装的工作，来看如何在page.xaml中使用这个控件。只需要三行代码：1、注册user control的命名空间（和对Silverlight API的引用是一样的，放在页面中的根元素UserControl里）：
xmlns:uc="clr-namespace:customcontrol"
        2、在页面中添加这个slider：
<Grid x:Name="LayoutRoot" Background="White">
        <!--地图在这里-->
        </esri:Map>
        
        <uc:mapslider x:Name="mapslider1"/>
</Grid>
        3、在初始化的时候对我们自定义控件的Map属性赋值（page.xaml.cs中）：
public Page()
      {
          InitializeComponent();
          mapslider1.Map = Map1;
      }
 
  
   到此应该有这个感觉，封装比较麻烦，但使用封装好的控件非常简便。这就是Widgets带给我们的好处。目前的beta版
中，SilverlightAPI已经替我们完成5个Widgets的封装，它们分别
是：Magnifier，ToolBar，BookMark，Navigation，MapTip，其中ToolBar内部使用了
ToolBarItemCollection和ToolBarItem等类。还是通过一个例子，来看看这几个控件都长什么样吧（点击这里）：

ArcGIS API for Silverlight开发入门

MapTip需要使用到Query Task，以后的小节中再涉及到。现在分别熟悉一下这几个Widgets的用法。
1、ToolBar和Magnifier：
 
  
   这个和ADF开发中的ToolBar（工具条）是一样的，里面可以添加ToolItem（工具），已实现各种功能，比如平移，缩放等。
silverlight中当然要有一些比较好看的效果了，比如把鼠标放在工具条上选择工具的时候，会有放大效果，这个效果是默认的，不能设置；点击一个工
具时，该工具会跳动一下，这个是ToolbarItemClickEffect中的Bounce效果（目前只有Bounce和None两个选择），也是默
认的。此例中ToolBar里面有三个ToolBarItem，分别是Pan，FullExtent和Magnifier（本身也是一个Widget），
下面是ToolBar的布局：

  1. <Grid Height="110" HorizontalAlignment="Right" VerticalAlignment="Top" Margin="0,10,10,0" >
  2. <Rectangle Fill="#22000000" RadiusX="10" RadiusY="10" Margin="0,4,0,0" />
  3. <Rectangle Fill="#775C90B2" Stroke="Gray"  RadiusX="10" RadiusY="10" Margin="0,0,0,5" />
  4. <Rectangle Fill="#66FFFFFF" Stroke="DarkGray" RadiusX="5" RadiusY="5" Margin="10,10,10,15" />
  5. <StackPanel Orientation="Vertical">
  6. <esriWidgets:Toolbar x:Name="MyToolbar" MaxItemHeight="80" MaxItemWidth="80"
  7. VerticalAlignment="Top" HorizontalAlignment="Center"
  8. ToolbarItemClicked="MyToolbar_ToolbarItemClicked"
  9. ToolbarItemClickEffect="Bounce"
  10. Width="250" Height="80">
  11. <esriWidgets:Toolbar.Items>
  12. <esriWidgets:ToolbarItemCollection>
  13. <esriWidgets:ToolbarItem Text="Pan">
  14. <esriWidgets:ToolbarItem.Content>
  15. <Image Source="img/i_pan.png" Stretch="UniformToFill" Margin="5" />
  16. </esriWidgets:ToolbarItem.Content>
  17. </esriWidgets:ToolbarItem>
  18. <esriWidgets:ToolbarItem Text="Full Screen">
  19. <esriWidgets:ToolbarItem.Content>
  20. <Image Source="img/i_globe.png" Stretch="UniformToFill" Margin="5" />
  21. </esriWidgets:ToolbarItem.Content>
  22. </esriWidgets:ToolbarItem>
  23. <esriWidgets:ToolbarItem Text="Full Screen">
  24. <esriWidgets:ToolbarItem.Content>
  25. <Image Source="img/magglass.png" Stretch="UniformToFill" Margin="5"
  26. MouseLeftButtonDown="Image_MouseLeftButtonDown"/>
  27. </esriWidgets:ToolbarItem.Content>
  28. </esriWidgets:ToolbarItem>
  29. </esriWidgets:ToolbarItemCollection>
  30. </esriWidgets:Toolbar.Items>
  31. </esriWidgets:Toolbar>
  32. <TextBlock x:Name="StatusTextBlock" Text="" FontWeight="Bold" HorizontalAlignment="Center"/>
  33. </StackPanel>
  34. </Grid>

复制代码

然后是code-behind内容：
private void MyToolbar_ToolbarItemClicked(object sender, ESRI.ArcGIS.Widgets.SelectedToolbarItemArgs e)
        {
            switch (e.Index)
            {
                case 0:
                    //pan
                    break;
                case 1:
                    Map1.ZoomTo(Map1.Layers.GetFullExtent());
                    break;
                case 2:
                    break;
            }
        }

private void Image_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)
        {
            MyMagnifier.Enabled = !MyMagnifier.Enabled;
        }
 
  
   别忘了在page的构造函数中加一句：MyMagnifier.Initialize(Map1);。可以看出，Pan工具不需要任何代码，因为地
图本身的默认动作就是Pan，而FullExtent也是利用了Map的ZoomTo()。放大镜的工具是在该图片被鼠标左键按住的过程中激活的（设置
enabled属性），只要鼠标左键没有按住放大镜图片，该Widget就设置为不可用。比较有用的是我们可以单独设置放大镜自己的图层及放大倍数，这里
放大镜使用的就是StreetMap，倍数为3。
2、BookMark：
    
   这个功能和ArcMap（9.3版本）中的BookMark是一样的，可以像看书一样，为当前地图范围设置一个书签，便于其他时候快速定位到该范
围。而查看API中的Bookmark.MapBookmark类（可以利用它对书签的内容进行单个添加或删除），可以发现其实每个书签存储的内容是一个
Extent，然后再起一个名字就可以了。添加了bookmark widget后似乎会造成vs中的preview窗口出错。
<!--bookmark-->
        <Canvas>
            <esriWidgets:Bookmark x:Name="MyBookmarks" Width="125" HorizontalAlignment="Left" VerticalAlignment="Top"
             Margin="20" Background="#99257194" BorderBrush="#FF92a8b3" Foreground="Black"
             Loaded="MyBookmarks_Loaded" />
        </Canvas>
page.xaml.cs中：
private void MyBookmarks_Loaded(object sender, RoutedEventArgs e)
        {
            MyBookmarks.Map = Map1;
        }
3、Navigation：
 
  
   这个导航条工具是目前网络地图必备的一个控件，但silverlight的功能，可以轻易实现地图的旋转（其实也可以在代码中通过
Map.Rotation属性来设置）。经试验这个widget只能放在StackPanel或Grid容器里，如果放在Canvas里的话地图中不会显
示。
<!--navigation bar.must be in a stackpanel-->
        <StackPanel HorizontalAlignment="Left" VerticalAlignment="Bottom">
            <esriWidgets:Navigation x:Name="MyNavigation" Margin="5"  />
        </StackPanel>
        同样在page的构造函数中添加一句：MyNavigation.Map = Map1;。
        API中的Widgets可以简化我们的工作，拿来即用。但明显的缺陷就是不灵活，如果想使自己的控件不那么千篇一律的话，就需要自己进行开发工作了。
原文地址:http://bbs.esrichina-bj.cn/ESRI/thread-44555-1-1.html

ArcGIS API for Silverlight开发入门（4）：用户与地理信息之间的桥梁--GraphicsLayer

   我们与地图交互的过程时刻在进行着：一个拉框放大操作，或者对地图内容的查询等。 这些交互过程中的输入输出，通常都是反映在独立于地图数据一个“层”上。比如拉框放大，我们能看见鼠标所画的一个矩形；又比如对兴趣点的查询，结果通常是 将符合条件的兴趣点的形状高亮显示在那个独立的“层”中，通过它既可以反映用户的输入，又可以展现地图的输出。这个“层”就是 GraphicsLayer。
        其实ADF开发中也有GraphicsLayer的概念，同样在其他两个客户端API（JavaScript/Flex）中也能找到GraphicsLayer的身影，它们都是一样一样的。
        本节我们主要看如何在GraphicsLayer中展现内容。当然第一个工作就是添加ESRI.ArcGIS.dll的引用，引入esri的xml命名空间；接下来在Map中添加一个GraphicsLayer图层：
  1. <esri:Map x:Name="Map1">
  2. <esri:Map.Layers>
  3. <!-- 其他图层 -->
  4. <esri:GraphicsLayer ID="GLayer" />
  5. </esri:Map.Layers>
  6. </esri:Map>

复制代码

要
使GraphicsLayer中的内容处于最顶端（不被其他图层内容覆盖），就要将它放在Map标签里的最下头，像上面那样。从命名我们不难看
出，GraphicLayer里面放的就是Graphic的集合了。Graphic（ESRI.ArcGIS.Graphic）是
GraphicsLayer中的基本元素，它包括了Geometry(在ESRI.ArcGIS.Geometry命名空间中)，Symbol（在
ESRI.ArcGIS.Symbol命名空间中），Attributes等属性。所有显示在地图中的矢量元素都有一个Geometry，里面包含了若干
地理坐标，用于显示地图上地物的形状，它是Point，Polyline，Polygon等的总称，在这里代表了Graphic的形状。Symbol代表
了Graphic的外观，它是一系列符号的总称，我们通常跟SimpleMarkerSymbol，SimpleLineSymbol和
SimpleFillSymbol等打交道，它们分别对应了上面3种不同的Geometry（Point，Polyline，Polygon）。
        要让一个Graphic显示出来，总共分3步：
1、定义Graphic：
在xaml中

  1. <esri:Graphic>
  2. </esri:Graphic>

复制代码

在code-behind中
Graphic g= new Graphic()
2、设置Graphic的Geometry和Symbol属性：
在xaml中

  1. <esri:Graphic>
  2. <esri:Graphic.Symbol>
  3. <esriSymbols:SimpleMarkerSymbol Color="Blue" Size="12" Style="Square" />
  4. </esri:Graphic.Symbol>
  5. <esriGeometry:MapPoint X="108" Y="30" />
  6. </esri:Graphic>

复制代码

在code-behind中

  1. Graphic g = new Graphic()
  2. {
  3. Geometry = new MapPoint(108, 30),
  4. Symbol = new SimpleMarkerSymbol()
  5. {
  6. Color = new SolidColorBrush(Colors.Blue),
  7. Size = 12,
  8. Style = SimpleMarkerSymbol.SimpleMarkerStyle.Square
  9. }
  10. };

复制代码

3、把定义好的Graphic添加到GraphicsLayer里：
在xaml中

  1. <esri:GraphicsLayer ID="GLayer">
  2. <esri:GraphicsLayer.Graphics>
  3. <esri:Graphic>
  4. <esri:Graphic.Symbol>
  5. <esriSymbols:SimpleMarkerSymbol Color="Blue" Size="12" Style="Square" />
  6. </esri:Graphic.Symbol>
  7. <esriGeometry:MapPoint X="108" Y="30" />
  8. </esri:Graphic>
  9. </esri:GraphicsLayer.Graphics>
  10. </esri:GraphicsLayer>

复制代码

在code-behind中

  1. Graphic g = new Graphic()
  2. {
  3. Geometry = new MapPoint(108, 30),
  4. Symbol = new SimpleMarkerSymbol()
  5. {
  6. Color = new SolidColorBrush(Colors.Blue),
  7. Size = 12,
  8. Style = SimpleMarkerSymbol.SimpleMarkerStyle.Square
  9. }
  10. };
  11. GraphicsLayer glayer = Map1.Layers["GLayer"] as GraphicsLayer;
  12. glayer.Graphics.Add(g);

复制代码

看一下效果：

ArcGIS API for Silverlight开发入门

图中还有其他的图形，无非是改变了Graphic的Geometry和Symbol属性。图上的那只灰熊是一段动画文件，利用Silverlight的特性，能够定义出表现力丰富的各种符号。
        尽管能够完全在xaml中来完成工作，但还是建议将可视化元素的定义放在xaml中，将实现的逻辑部分放在code-behind中。看一下添加图中那些Graphic的代码：

  1. <Grid.Resources>
  2. <esriSymbols:SimpleMarkerSymbol x:Name="RedMarkerSymbol" Color="Red" Size="12" Style="Circle" />
  3. <!-- 可惜目前Silverlight只支持Jpeg和PNG格式的图像，所以PictureMarkerSymbol无法显示GIF格式的图像，否则会报ImagingError的错误 -->
  4. <esriSymbolsictureMarkerSymbol x:Name="PinPictureMarkerSymbol" Source="imgs/pin.png" OffsetX="10" OffsetY="10" />
  5. <esriSymbols:SimpleLineSymbol x:Name="RedLineSymbol" Color="Red" Width="4" Style="Solid" />
  6. <esriSymbols:CartographicLineSymbol
    x:Name="CartoLineSymbol" Color="Red" Width="10" DashCap="Triangle"
    LineJoin="Round" DashArray="6,2" />
  7. <esriSymbols:SimpleFillSymbol x:Name="RedFillSymbol" Fill="#66FF0000" BorderBrush="Red" BorderThickness="2" />
  8. </Grid.Resources>
  9. <MediaElement x:Name="BearVideo" />

复制代码

  1. private void AddGraphics()
  2. {
  3. GraphicsLayer glayer = Map1.Layers["GLayer"] as GraphicsLayer;
  4. Graphic[] graphics = new Graphic[8];
  5. graphics[0] = new Graphic()
  6. {
  7. Geometry = new MapPoint(108, 34),
  8. Symbol = RedMarkerSymbol
  9. };
  10. graphics[1] = new Graphic()
  11. {
  12. Geometry = new MapPoint(108, 30),
  13. Symbol = new SimpleMarkerSymbol()
  14. {
  15. Color = new SolidColorBrush(Colors.Blue),
  16. Size = 12,
  17. Style = SimpleMarkerSymbol.SimpleMarkerStyle.Square
  18. }
  19. };
  20. graphics[2] = new Graphic()
  21. {
  22. Geometry = new MapPoint(108, 25),
  23. Symbol = PinPictureMarkerSymbol
  24. };
  25. graphics[3] = new Graphic()
  26. {
  27. Geometry = new MapPoint(108, 20),
  28. Symbol = new TextSymbol()
  29. {
  30. FontFamily = new FontFamily("微软雅黑, 宋体"),
  31. FontSize = 14,
  32. Foreground = new SolidColorBrush(Colors.Black),
  33. Text = "这是text symbol"
  34. }
  35. };
  36. graphics[4] = new Graphic();
  37. graphics[4].Symbol = RedLineSymbol;
  38. ESRI.ArcGIS.Geometry.PointCollection pc = new ESRI.ArcGIS.Geometry.PointCollection()
  39. {
  40. new MapPoint(95,10),
  41. new MapPoint(110,-15),
  42. new MapPoint(130,10)
  43. };
  44. ESRI.ArcGIS.Geometry.Polyline pl = new ESRI.ArcGIS.Geometry.Polyline();
  45. pl.Paths.Add(pc);
  46. graphics[4].Geometry = pl;
  47. graphics[5] = new Graphic();
  48. graphics[5].Symbol = CartoLineSymbol;
  49. ESRI.ArcGIS.Geometry.PointCollection pc1 = new ESRI.ArcGIS.Geometry.PointCollection()
  50. {
  51. new MapPoint(95,0),
  52. new MapPoint(110,-25),
  53. new MapPoint(130,0)
  54. };
  55. ESRI.ArcGIS.Geometry.Polyline pl1 = new ESRI.ArcGIS.Geometry.Polyline();
  56. pl1.Paths.Add(pc1);
  57. graphics[5].Geometry = pl1;
  58. graphics[6] = new Graphic()
  59. {
  60. Symbol = RedFillSymbol
  61. };
  62. ESRI.ArcGIS.Geometry.PointCollection pc2 = new ESRI.ArcGIS.Geometry.PointCollection()
  63. {
  64. new MapPoint(110,-30),
  65. new MapPoint(130,-30),
  66. new MapPoint(130,-45),
  67. new MapPoint(120,-55),
  68. new MapPoint(110,-45),
  69. new MapPoint(110,-30)
  70. };
  71. ESRI.ArcGIS.Geometry.Polygon pg = new ESRI.ArcGIS.Geometry.Polygon();
  72. pg.Rings.Add(pc2);
  73. graphics[6].Geometry=pg;
  74. graphics[7] = new Graphic();
  75. //MediaElement的Name属性只能在xaml中定义（见帮助），所以决定了MediaElement不能完全在cs代码中定义
  76. BearVideo.Source = new Uri("http://serverapps.esri.com/media/bear.wmv", UriKind.RelativeOrAbsolute);
  77. BearVideo.IsHitTestVisible=false;
  78. BearVideo.IsMuted=true;
  79. BearVideo.AutoPlay=true;
  80. BearVideo.Opacity=0;
  81. ESRI.ArcGIS.Geometry.Polygon pg2 = new ESRI.ArcGIS.Geometry.Polygon();
  82. ESRI.ArcGIS.Geometry.PointCollection pc3 = new ESRI.ArcGIS.Geometry.PointCollection()
  83. {
  84. new MapPoint(10,-20),
  85. new MapPoint(32,7),
  86. new MapPoint(62,-35),
  87. new MapPoint(11,-36),
  88. new MapPoint(10,-20)
  89. };
  90. pg2.Rings.Add(pc3);
  91. graphics[7].Geometry=pg2;
  92. graphics[7].Symbol = new SimpleFillSymbol()
  93. {
  94. Fill = new VideoBrush()
  95. {
  96. SourceName = BearVideo.Name,
  97. Opacity = 0.6,
  98. Stretch = Stretch.UniformToFill
  99. }
  100. };
  101. foreach (Graphic g in graphics)
  102. {
  103. glayer.Graphics.Add(g);
  104. g.MouseLeftButtonDown+=new MouseButtonEventHandler(graphic_MouseLeftButtonDown);
  105. }
  106. }
  107. private void graphic_MouseLeftButtonDown(object o,MouseButtonEventArgs e)
  108. {
  109. Graphic g=o as Graphic;
  110. MessageBox.Show(string.Format("Geometry:{0}\nSymbol:{1}",g.Geometry.GetType().ToString(),g.Symbol.GetType().ToString()));
  111. }

复制代码

可
以看到，完全能够在一个Graphic上定义一些事件，来达到程序的目的。大家可以试着把上面的内容在xaml中改写一遍。看到这里肯定会产生一个疑问：
难道每个Geometry的定义都这么困难吗？其实SilverlightAPI已经给我们提供了ESRI.ArcGIS.Draw（继承自xaml中的
Canvas）类，它能非常方便的捕捉到用户的鼠标操作，从而获取各种Geometry来供程序使用。
    
   可以把Draw理解成一块画板，调用Draw的Active()方法，就可以开始在画板上面绘画，程序会自动记录鼠标画出的每个Geometry，
调用DeActive()方法，停止绘画。Active()有一个DrawMode参数，它决定了我们即将在这个画板上画出的内容类
型：Point，Polyline，Polygon等。在画的过程中我们可以看到地图上可以实时反映出我们绘画的内容，而这些则利用了Draw的预定义
Symbol：DefaultMarkerSymbol，DefaultLineSymbol，DefaultPolygonSymbol等。对应关系如
下：

ArcGIS API for Silverlight开发入门

每当完成一个图形的绘制，就会触发Draw.OnDrawComplete事件，利用事件参数就可以获得Geometry，之后可以创建一个
Graphic，设置一个Symbol（一般使用Draw的预定义Symbol），把画好的这个Graphic添加到一个GraphicsLayer中。
        点击这里，查看一个比较完整的Graphics的例子。
最后来看一下这个例子的部分代码：

  1. <Grid.Resources>
  2. <esriSymbols:SimpleMarkerSymbol x:Name="DefaultMarkerSymbol" Color="Red" Size="12" Style="Circle" />
  3. <esriSymbols:CartographicLineSymbol x:Name="DefaultLineSymbol" Color="Red" Width="4" />
  4. <esriSymbols:SimpleFillSymbol x:Name="DefaultFillSymbol" Fill="#33FF0000" BorderBrush="Red" BorderThickness="2" />
  5. <esriSymbols:SimpleFillSymbol x:Name="DefaultPolygonSymbol" Fill="#33FF0000" BorderBrush="Red" BorderThickness="2" />
  6. </Grid.Resources>
  7. <esriraw x:Name="Draw1"
  8. DefaultRectangleSymbol="{StaticResource DefaultFillSymbol}"
  9. DefaultMarkerSymbol="{StaticResource DefaultMarkerSymbol}"
  10. DefaultLineSymbol="{StaticResource DefaultLineSymbol}"
  11. DefaultPolygonSymbol="{StaticResource DefaultPolygonSymbol}"
  12. Loaded="Draw1_Loaded"
  13. OnDrawComplete="Draw1_OnDrawComplete" />
  14. <Canvas VerticalAlignment="Top" HorizontalAlignment="Left" Margin="20,20,0,0" Width="430" Height="110">
  15. <Rectangle RadiusX="10" RadiusY="10" Width="430" Height="110" Fill="#98000000" Stroke="#FF6495ED" />
  16. <Rectangle
    Fill="#FFFFFFFF" Stroke="DarkGray" RadiusX="5" RadiusY="5"
    Canvas.Left="10" Canvas.Top="10" Width="410" Height="90" />
  17. <StackPanel Orientation="Vertical" Canvas.Top="5" Canvas.Left="20">
  18. <esriWidgets:Toolbar x:Name="ToolBar1" MaxItemHeight="80" MaxItemWidth="80" Width="380" Height="80"
  19. ToolbarIndexChanged="ToolBar1_ToolbarIndexChanged"
  20. ToolbarItemClicked="ToolBar1_ToolbarItemClicked">
  21. <esriWidgets:Toolbar.Items>
  22. <esriWidgets:ToolbarItemCollection>
  23. <esriWidgets:ToolbarItem Text="添加点">
  24. <esriWidgets:ToolbarItem.Content>
  25. <Image Source="imgs/DrawPoint.png" Stretch="UniformToFill" Margin="5" />
  26. </esriWidgets:ToolbarItem.Content>
  27. </esriWidgets:ToolbarItem>
  28. <esriWidgets:ToolbarItem Text="添加折线">
  29. <esriWidgets:ToolbarItem.Content>
  30. <Image Source="imgs/DrawPolyline.png" Stretch="UniformToFill" Margin="5" />
  31. </esriWidgets:ToolbarItem.Content>
  32. </esriWidgets:ToolbarItem>
  33. <esriWidgets:ToolbarItem Text="添加多边形">
  34. <esriWidgets:ToolbarItem.Content>
  35. <Image Source="imgs/DrawPolygon.png" Stretch="UniformToFill" Margin="5" />
  36. </esriWidgets:ToolbarItem.Content>
  37. </esriWidgets:ToolbarItem>
  38. <esriWidgets:ToolbarItem Text="添加矩形">
  39. <esriWidgets:ToolbarItem.Content>
  40. <Image Source="imgs/DrawRectangle.png" Stretch="UniformToFill" Margin="5" />
  41. </esriWidgets:ToolbarItem.Content>
  42. </esriWidgets:ToolbarItem>
  43. <esriWidgets:ToolbarItem Text="添加曲线">
  44. <esriWidgets:ToolbarItem.Content>
  45. <Image Source="imgs/DrawFreehand.png" Stretch="UniformToFill" Margin="5" />
  46. </esriWidgets:ToolbarItem.Content>
  47. </esriWidgets:ToolbarItem>
  48. <esriWidgets:ToolbarItem Text="停止添加动作">
  49. <esriWidgets:ToolbarItem.Content>
  50. <Image Source="imgs/StopDraw.png" Stretch="UniformToFill" Margin="5" />
  51. </esriWidgets:ToolbarItem.Content>
  52. </esriWidgets:ToolbarItem>
  53. <esriWidgets:ToolbarItem Text="清空绘制的图形">
  54. <esriWidgets:ToolbarItem.Content>
  55. <Image Source="imgs/eraser.png" Stretch="UniformToFill" Margin="5" />
  56. </esriWidgets:ToolbarItem.Content>
  57. </esriWidgets:ToolbarItem>
  58. </esriWidgets:ToolbarItemCollection>
  59. </esriWidgets:Toolbar.Items>
  60. </esriWidgets:Toolbar>
  61. <TextBlock x:Name="StatusTextBlock" Text="" FontWeight="Bold" HorizontalAlignment="Center"/>
  62. </StackPanel>
  63. </Canvas>

复制代码

  1. private void Draw1_Loaded(object sender, RoutedEventArgs e)
  2. {
  3. Draw1.Map = Map1;
  4. }
  5. private void Draw1_OnDrawComplete(object sender, ESRI.ArcGIS.DrawEventArgs args)
  6. {
  7. ESRI.ArcGIS.GraphicsLayer graphicsLayer = Map1.Layers["GLayer2"] as ESRI.ArcGIS.GraphicsLayer;
  8. ESRI.ArcGIS.Graphic graphic = new ESRI.ArcGIS.Graphic()
  9. {
  10. Geometry = args.Geometry,
  11. Symbol = _activeSymbol,
  12. };
  13. graphicsLayer.Graphics.Add(graphic);
  14. }
  15. private void ToolBar1_ToolbarIndexChanged(object sender, ESRI.ArcGIS.Widgets.SelectedToolbarItemArgs e)
  16. {
  17. StatusTextBlock.Text = e.Item.Text;
  18. }
  19. private void ToolBar1_ToolbarItemClicked(object sender, ESRI.ArcGIS.Widgets.SelectedToolbarItemArgs e)
  20. {
  21. Draw1.Deactivate();
  22. switch (e.Index)
  23. {
  24. case 0: // Point
  25. Draw1.Activate(ESRI.ArcGIS.DrawMode.Point);
  26. _activeSymbol = strobeSymbol;
  27. break;
  28. case 1: // Polyline
  29. Draw1.Activate(ESRI.ArcGIS.DrawMode.Polyline);
  30. _activeSymbol = DefaultLineSymbol;
  31. break;
  32. case 2: // Polygon
  33. Draw1.Activate(ESRI.ArcGIS.DrawMode.Polygon);
  34. _activeSymbol = DefaultPolygonSymbol;
  35. break;
  36. case 3: // Rectangle
  37. Draw1.Activate(ESRI.ArcGIS.DrawMode.Rectangle);
  38. _activeSymbol = DefaultFillSymbol;
  39. break;
  40. case 4: // Freehand
  41. Draw1.Activate(ESRI.ArcGIS.DrawMode.Freehand);
  42. _activeSymbol = waveLineSymbol;
  43. break;
  44. case 5: // Stop Graphics
  45. break;
  46. case 6: // Clear Graphics
  47. ESRI.ArcGIS.GraphicsLayer graphicsLayer = Map1.Layers["GLayer2"] as ESRI.ArcGIS.GraphicsLayer;
  48. graphicsLayer.ClearGraphics();
  49. break;
  50. }
  51. }

复制代码

大家可以注意一下例子中添加的点符号和曲线符号。只要有足够的想象力，完全可以利用Silverlight定制出非常炫的符号效果来。
原文地址:http://bbs.esrichina-bj.cn/ESRI/thread-44892-1-1.html

ArcGIS API for Silverlight开发入门（5）：任务外包——Tasks

 通过上一节的学习，我们已经知道了如何与GraphicLayer交互，但毕竟GIS不是一个画板，所以这节来看一下如何通过Silverlight API完成GIS中的分析功能。
        GIS之所以是一个通用的工具，就是因为它具有各种各样分析和处理数据的能力。Silverlight API中提供了Task，使我们能够轻松完成常见的分析任务。
        先来考虑一下吃饺子的场景。要想吃饺子，我们需要先去买菜，买肉，回家后在厨房里洗菜，揉面， 拌馅，包饺子，煮饺子，吃饺子，之后别忘了洗碗；另一种情况就是去饭馆，告诉服务员我要吃3两茴香，3两韭菜的饺子，然后等着饺子端到你面前，开吃，走人。
 
  
   在ArcGISServer程序开发中，要完成GIS的分析功能其实和吃饺子是一样的。用ADF编程就像在家里吃饺子，除了架设服务器，所有的工作
基本上也都得我们自己在服务器端来完成，要处理的地方比较多；而用客户端API编程相当于去外面吃饺子，我们只要把任务交给相应的Task，之后接受结果
就行了，不用做饺子。唯一不同的就是在外面吃完饺子别忘了付钱，而用Task完成分析任务则是免费的。这点也体现在使用客户端API中的Task时，是由
ArcGISOnline提供给你的，不需要自己购买AGS软件。
        现在来看看Silverlight API目前给我们提供了那些Task功能：
Query：能够在已经发布的服务数据中，通过属性条件（可以属性字段中进行关系判断，字符查找等），图形条件（与输入的图形相交、包含、相离等），或者是两者的组合，查询出满足条件的数据并返回。相当于Engine中的SpatialFilter，当然也是QueryFilter。
Find：在地图数据的属性字段中查找包含有关键字参数的数据并返回。
Identity：对鼠标当前点击位置上的数据进行辨识并返回结果，可以对多个图层的数据进行辨识。
Address Locator：输入经纬度，返回地址结果（Geocoding）；输入一个地方的地址，返回经纬度结果（Reverse Geocoding）。由于国内地图数据保密工作做的相当好，这个Task暂时用不到。
Geometry Service：可以对输入的地理数据进行如缓冲区，动态投影，面积/周长量算等几何操作。
Geoprocessing：能够完成复杂的GIS任务，类似ToolBox中的工具。
 
  
   抽象一下，可以看出，Query完全可以完成Identity和Find的工作，但后两者在特定场合下使用起来比Query要方便的
多；Geoprocessing完全可以替代Geometry Service，但是在利用REST
API编写的程序中，要尽量使用GeometryService。
        再抽象一下，Silverlight API中的这几个Task和JavaScript/FlexAPI中的Task是大同小异的，因为其实它们都是AGS 9.3 REST API中暴露出来的操作资源（OperationResource）见下图：

ArcGIS API for Silverlight开发入门

后面的代码中实际上也是把输入参数封装起来提交到了REST API的特定Endpoint上。要理解好客户端API中的Task，建议熟读AGS的REST SDK。
        Task的用法基本上相同，都遵循这几个步骤：初始化Task，设置Task所需参数，提交任务，等待服务器完成任务后，处理返回的结果；进饭馆，想好你要吃什么饺子，告诉服务员，等饺子做好端上来，开始吃。好了，下面我们就通过一个实例（点击这里，查看实例），来学习一下Query和Geometry两个Task的用法。

ArcGIS API for Silverlight开发入门

首先选择工具条中的画线工具，在屏幕上画一条曲线，会根据曲线自动生成一个距离100公里的缓冲区显示在地图上，之后开始查询缓冲区图形经过的州
（相交），将结果显示在地图上。可以单击每个州查看详细信息。这里假设你已学习了前几节的内容，只讨论Task用法的部分。
1、利用所画的线生成缓冲区。画线利用的是Draw工具中的Freehand，在这个动作完成后会触发Draw的OnDrawCompleted事件，自然可以在这里开始进行缓冲区的工作，用的是Geometry Service里的Buffer。
        初始化Geometry Service。假设已经在Map1中添加了ID为glayerResult的GraphicsLayer，linesymbolred是提前设置好的CartographicLineSymbol：

  1. private void Draw1_OnDrawComplete(object sender, DrawEventArgs args)
  2. {
  3. Draw1.Deactivate();//Freehand动作失效
  4. //将Freehand画的曲线显示在地图上
  5. GraphicsLayer glayer = Map1.Layers["glayerResult"] as GraphicsLayer;
  6. Graphic g = new Graphic();
  7. g.Symbol = linesymbolred;
  8. g.Geometry = args.Geometry;
  9. glayer.Graphics.Add(g);
  10. //初始化Geometry Service
  11. GeometryService
    geometrytask = new
    GeometryService("http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Geometry/GeometryServer");
  12. }

复制代码

GeometryService
的初始化使用构造函数来完成的，里面接受一个URL，这个是Geometry Service的REST
APIEndpoint。顺便说一下，不同于其他服务比如MapService，一个GISServer只能发布一个GeometryService，并
且它的名称必须是Geometry。
        当一个Task完成时会触发Completed事件，失败时也有Failed事件，对这两个事件进行监听：

  1. geometrytask.BufferCompleted += new EventHandler(geometrytask_BufferCompleted);
  2. geometrytask.Failed += new EventHandler(geometrytask_Failed);

复制代码

设置Buffer操作所需的参数：

  1. BufferParameters bufferparameters = new BufferParameters();
  2. bufferparameters.Unit = LinearUnit.Kilometer;
  3. //必须指定下面两个spatialreference，否则buffer结果集为空
  4. bufferparameters.BufferSpatialReference = new SpatialReference(3395);
  5. bufferparameters.OutSpatialReference = Map1.SpatialReference;
  6. bufferparameters.Distances.Add(100);
  7. bufferparameters.Features.Add(g);

复制代码

BufferParameters
是专门用于Buffer的参数；BufferSpatialReference是将要Buffer的图形重新投影到这个坐标系下（常常需要根据地图数据所
在地方的情况来设置这个参数），并设置Buffer距离的单位为公里，Buffer的输出一般与地图坐标系一致；Buffer参数有一个Features
属性，是List类型，里面的Graphic都将被Buffer。下来将Buffer的任务提交到服务器（可以看出为什么这些动作要叫Task）：

  1. geometrytask.BufferAsync(bufferparameters);

复制代码

以
上代码都放在Draw1_OnDrawComplete函数中。任务提交到服务器后，由GeometryService接管，计算，完成后会立刻将结果返
回给我们，通知我们结果已经完成的方式就是前面绑定的Completed事件。接收到结果后，首先将缓冲区显示出来：

  1. private void geometrytask_BufferCompleted(object sender, GraphicsEventArgs args)
  2. {
  3. if (args.Results.Count>0)
  4. {
  5. GraphicsLayer glayer = Map1.Layers["glayerResult"] as GraphicsLayer;
  6. Graphic g = new Graphic();
  7. g.Symbol = fillsymbolBuffer;
  8. g.Geometry = args.Results[0].Geometry;
  9. glayer.Graphics.Add(g);
  10. }
  11. }

复制代码

如图：

ArcGIS API for Silverlight开发入门

2、利用生成缓冲区的缓冲区进行空间查询。要达到我们的目的，就还需要进行一个Query的Task，那么就可以在这里马不停蹄的开始Query的Task。步骤基本都是一样的，初始化，设置参数，提交结果，处理结果：

  1. private void geometrytask_BufferCompleted(object sender, GraphicsEventArgs args)
  2. {
  3. if (args.Results.Count>0)
  4. {
  5. GraphicsLayer glayer = Map1.Layers["glayerResult"] as GraphicsLayer;
  6. Graphic g = new Graphic();
  7. g.Symbol = fillsymbolBuffer;
  8. g.Geometry = args.Results[0].Geometry;
  9. glayer.Graphics.Add(g);
  10. //初始化QueryTask
  11. QueryTask
    querytask = new
    QueryTask("http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographics/ESRI_Census_USA/MapServer/5");
  12. //准备接收结果或者处理失败的通知
  13. querytask.ExecuteCompleted += new EventHandler(querytask_ExecuteCompleted);
  14. querytask.Failed += new EventHandler(querytask_Failed);
  15. //设置Query Task所需的参数
  16. Query query = new Query();
  17. query.OutFields.Add("*");//也顺便设置了query.ReturnGeometry=true;
  18. query.Geometry = g.Geometry;
  19. query.SpatialRelationship = SpatialRelationship.esriSpatialRelIntersects;
  20. //向服务器上的对应图层提交任务
  21. querytask.ExecuteAsync(query);
  22. Map1.Cursor = System.Windows.Input.Cursors.Wait;
  23. }
  24. }

复制代码

这
里的查询实在美国州的图层上进行的，详细信息将QueryTask构造函数里的那个参数输入浏览器查看；query.Geometry是设置需要进行空间
查询的图形，就是上面缓冲区的结果；OutFields是查询结果需要返回的字段，这里返回全部字段，如果返回全部字段，则强制设置了
ReturnGeometry为true，如果我们不需要处理结果的图形信息，则可以将这个参数设为false，以节省流量，显然这里不是；空间关系可以
参考API，与Engine中的完全一致。
        接下来处理QueryTask完成后的结果：

  1. private void querytask_ExecuteCompleted(object sender, QueryEventArgs args)
  2. {
  3. GraphicsLayer graphicslayer = Map1.Layers["glayerResult"] as GraphicsLayer;
  4. FeatureSet featureset = args.FeatureSet;
  5. if (featureset != null && featureset.Features.Count > 0)
  6. {
  7. graphicslayer.ClearGraphics();
  8. listboxResults.Items.Clear();
  9. foreach (Graphic graphic in featureset.Features)
  10. {
  11. graphic.Symbol = fillsymbolresult;
  12. graphicslayer.Graphics.Add(graphic);
  13. }
  14. }
  15. MyMapTip.GraphicsLayer = graphicslayer;
  16. Map1.Cursor = System.Windows.Input.Cursors.Arrow;
  17. }

复制代码

上
面处理空间查询的结果只是将图形显示了出来，那么对于单击某个州后，显示出其详细信息该怎么办呢？从图一可以看出，用到了Silverlight的
DataGrid控件，信息从哪里去呢？记得上面我们设置结果中返回的全部属性字段吗？它们存储在每个Graphic的Attributes属性中。要么
绑定到DataGrid里，要么一条条添加……你可能已经发现了这条语句MyMapTip.GraphicsLayer
=graphicslayer;，还记得第三节的Widgets吗？那里我们落下了MapTip这个小家伙，现在派上用场了。除了在这里设置MapTip
的GraphicsLayer属性外，在xaml中有如下的定义：

  1. <esriWidgets:MapTip x:Name="MyMapTip" BorderBrush="#99000000"
  2. BorderThickness="1" Title="详细信息" VerticalOffset="10"
  3. HorizontalOffset="10" Background="#DDFFFFFF" />

复制代码

仅此而已。MapTip会自动找寻自己GraphicsLayer中的Graphic，当鼠标悬停在某个Grpahic上时，会自动读取它的Attributes属性并显示，小玩具又发挥了大作用。
        别忘了万一处理任务失败时的提示：

  1. private void geometrytask_Failed(object sender, TaskFailedEventArgs args)
  2. {
  3. MessageBox.Show("Buffer Error:" + args.Error);
  4. }
  5. private void querytask_Failed(object sender, TaskFailedEventArgs args)
  6. {
  7. MessageBox.Show("Query failed: " + args.Error);
  8. Map1.Cursor = System.Windows.Input.Cursors.Arrow;
  9. GraphicsLayer graphicslayer = Map1.Layers["glayerResult"] as GraphicsLayer;
  10. graphicslayer.ClearGraphics();
  11. }

复制代码

本节内容完毕。上面讲的相对简略，要理解各个Task和参数的用法，还是需要熟悉Silverlight API和
前面提到的REST API。另外，Geoprocessing
Service实际上是最强大Task，如果有自己的GISServer，完全可以在上面发布自制的Model或者Python脚本，以完成各种GIS分
析任务，简单的在线编辑也是可能的。它的用法也万变不离其宗：初始化，设置参数，提交任务，处理结果。不同的是GeoprocessingService
有两种提交任务的方法：同步和异步。前者服务器端处理完任务后会立即将结果发送回客户端；后者将任务提交后会得到服务器端返回的一个JobID，即使任务
处理完成也不会立即返回，而是需要你拿这个JobID去询问服务器：完成了吗？完成了吗？完成了吗？如果完成，则可以取回相应的结果。
    
   前面说到，虽然去外面吃饺子很方便，但是毕竟那是人家做好的，对于老饕来说还需要自己的口感，自己下厨毕竟能控制整个过程的方方面面，哪怕你想做出
饺立方也都是有可能的。同样，ADF编程可以调用服务器端的ArcObjects，让你为所欲为，这点是客户端API无论如何也办不到的。
原文地址:http://bbs.esrichina-bj.cn/ESRI/thread-45302-1-1.html

ArcGIS API for Silverlight开发入门（6）：图层类型小结

  在用SilverlightAPI开发的过程中，不论是从客户端提交到服务器端的数 据，还是从服务器端返回客户端的数据，都要表现在浏览器中，具体的来说是Map控件里。但根据各自类型的不同，比如数据源，地图服务的类型，是否缓存等， 决定了它们将处于某个图层里，前面讲过的GraphicsLayer就是一种图层。清楚地认识这些图层类型，对于处理于服务器与客户端之间的地图数据来说 是很重要的。
        所有的图层都是从Layer类型继承而来的，可以参考下载的API中的对象模型图。
Layer
  |--TiledMapServiceLayer
  |       |--ArcGISTiledMapServiceLayer
  |--DynamicLayer
  |       |--DynamicMapServiceLayer
  |                 |--ArcGISDynamicMapServiceLayer
  |                 |--ArcGISImageServiceLayer
  |                 |--GPResultImageLayer
  |--GraphicsLayer
  |       |--FeatureLayer
  |--ElementLayer
        下面就按顺序认识一下这些图层吧，也包括Silverlight API中独有的FeatureLayer。

1、Layer：
        继承自Silverlight中的DependencyObject，并实现了INotifyPropertyChanged接口，是Silverlight API中其他图层的基类。可以把它看成麦子，再好吃的凉皮，泡馍都是由它做出来的；

2、TiledMapServiceLayer：
        继承自Layer，是所有使用了缓存的地图服务的基类。通过它可以在程序中加入经过缓存的，来自不同数据源的地图服务。比如ArcGIS Server的地图服务，Google Map的地图，Virtual Earth的地图等；

3、ArcGISTiledMapServiceLayer:
 
  
   继承自TiledMapServiceLayer。像上面说的一样，这个图层扩展了TiledMapServiceLayer，于是支持由
ArcGISServer 9.3版本发布的经过缓存的地图服务；又比如ArcGIS
Server9.2版本发布的缓存地图服务不支持REST方式连接，如果要在93的客户端API中使用的话，就可以通过
TiledMapServiceLayer扩展一个比如ArcGISTiledMapServiceLayer92，来支持92Server发布的缓存地
图服务；

4、DynamicLayer：
        继承自Layer，是动态地图服务的基类；

5、DynamicMapServiceLayer：
        继承自DynamicLayer，对应于TiledMapServiceLayer，要使用未经过缓存的动态地图服务，就得通过扩展这个图层来实现；

6、ArcGISDynamicMapServiceLayer：
 
      继承自DynamicMapServiceLayer，针对ArcGIS
Server9.3版本发布的动态地图服务。同理，如果要在客户端API中使用其他动态地图服务，比如OGC的WMS服务，则也需要像这个图层一样，扩展
上面的DynamicMapServiceLayer来实现；

7、ArcGISImageServiceLayer：
    
   继承自DynamicMapServiceLayer，针对ArcGIS Server
9.3版本发布的ImageService，因为影像服务也属于动态的地图服务。在客户端API中，可以通过
ArcGISImageServiceLayer的一些属性，方便通过浏览器来展示服务器端的影像数据，比如通过BandIds属性，可以快速调整影像数
据显示波段的组合（RGB通道），提供不同结果供用户查看。点击这里，查看一个实例；

8、GPResultImageLayer：
        继承自DynamicMapServiceLayer，针对Geoprocessing服务所产生的结果。可以请求服务器端的GP服务将结果动态生成一张图片，将此图片作为GPResultImageLayer图层直接添加到Map控件中；

9、GraphicsLayer：
        继承自Layer，是图形数据集中展现的地方，在第四讲中已经详细讨论过了；

10、FeatureLayer：
        继承自GraphicsLayer，这也是Silverlight API中的亮点之一，通过它可以完成一个比较炫的功能：

ArcGIS API for Silverlight开发入门

整个过程在xaml中就可以实现，只需要在Map的Layers中插入以下代码即可：

  1. <esri:ArcGISTiledMapServiceLayer ID="StreetMapLayer"
    Url="http://server.arcgisonline.com/ArcGIS/rest/services/ESRI_StreetMap_World_2D/MapServer"/>
  2. <esri:FeatureLayer ID="featurelayer"
  3. Url="http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Specialty/ESRI_StatesCitiesRivers_USA/MapServer/0"
  4. Where="POP1990 > 75000" ClusterFeatures="True" FlareBackground="#99FF0000" FlareForeground="White" MaximumFlareCount="9"
  5. FeatureSymbol="{StaticResource markersymbol}">
  6. <esri:FeatureLayer.OutFields>
  7. <sys:String>CITY_NAME</sys:String>
  8. <sys:String>POP1990</sys:String>
  9. </esri:FeatureLayer.OutFields>
  10. <esri:FeatureLayer.MapTip>
  11. <Grid Background="LightYellow">
  12. <StackPanel Margin="5">
  13. <TextBlock Text="{Binding Converter={StaticResource MyDictionaryConverter},
  14. ConverterParameter=CITY_NAME, Mode=OneWay}" FontWeight="Bold" />
  15. <StackPanel Orientation="Horizontal">
  16. <TextBlock Text="Population (1990): " />
  17. <TextBlock Text="{Binding Converter={StaticResource MyDictionaryConverter},
  18. ConverterParameter=POP1990, Mode=OneWay}" />
  19. </StackPanel>
  20. </StackPanel>
  21. <Border BorderBrush="Black" BorderThickness="1" />
  22. </Grid>
  23. </esri:FeatureLayer.MapTip>
  24. </esri:FeatureLayer>

复制代码

可
以看出这个FeatureLayer其实是将一个Query查询封装到了一个GraphicsLayer中。通过url指定查询的图层，where指定查
询条件（也可以输入geometry指定查询的图形），最关键的是ClusterFeatures="True"，当一个范围内feature过多时，就
将他们“聚合”在一起，以一个更大的符号表示出来，进一步放大时才将它们单独显示出来，如果聚合的目标不超过MaximumFlareCount设置的数
目，那么就会出现那个flare动画。在MapTip（继承自GraphicsLayer）里面进行了简单的设置，一个背景为黄色的Grid里显示两行文
字，用一个DictionaryConverter类将返回的Graphic.Attributes集合中的两个字段转换成String类型显示出来。顺
便提一下，FeatureLayer也可以用于线或面层的查询，但如果继续使用ClusterFeatures的话就没什么意义了。虽然
FeatureLayer封装的比较死，只能有此一种效果，但它提供给我们一种思路，可以结合SilverlightRIA的特性，充分发挥自己的想象力
做出更炫的效果来；但是，对于需要展现海量（成百上千个）点数据的图层来说，ClusterFeatures是一个非常有用的特性，毕竟将这么多点同时呈
现出来性能还是有问题的。如果不使用ClusterFeatures，看起来应该是这样的：

ArcGIS API for Silverlight开发入门

不用FeatureLayer行吗？
    
   说到FeatureLayer，还有两个Renderer不得不提一下：UniqueValueRenderer和
ClassBreakerRenderer。它们都是依托FeatureLayer的，用于单值专题图的渲染。具体的用法都比较简单，可以查看API中的
Concepts。但Samples中的ThematicRendering例子并没有采用这两种Renderer，而是人为地为每个Graphic设置
了不同的Symbol。目前看来虽然这两个Renderer有点鸡肋，但毕竟是现在3种客户端API中提供的唯一现成的Renderer，可以猜想也许下
个版本的SilverlightAPI中会有更加成熟的专题图Renderer直接供我们使用；

11、ElementLayer：
 
  
   继承自Layer，它可以用来专门呈现Silverlight中原生的FrameworkElement，比如视频，音频等。虽然在
FillSymbol的Fill属性中也能利用Brush类来展现一段视频，但毕竟有些“小气”，在ElementLayer中可以大大方方的放置
Silverlight元素。你可能会问，在Map控件之外，Grid等布局元素中不是也能放置Silverlight的东西吗，为什么要放在
ElementLayer里呢？其实有个问题经常困扰GIS开发人员，就是想让一些非地理数据元素随着地图范围的变化（放大，缩小，平移）而变化，而无须
自己在Extent变化后重新计算客户端坐标，手工改变这些元素的位置。瞧，ElementLayer正解决了这个问题。

目前Beta版的API中暂时有这么多图层类型，以后也许会继续增加。但万变不离其宗，无非就是从那几个基类中派生出来的。所以，下一节我们就通过
一个实例来看看如何扩展基类的MapServiceLayer，来达到使用非ArcGIS Server数据源的目的。

原文地址:http://bbs.esrichina-bj.cn/ESRI/thread-45537-1-1.html

ArcGIS API for Silverlight开发入门（7）：使用非AGS数据源的图层

 通过上一节学习，可以看出在Silverlight API中不仅可以轻松使用ArcGIS Server9.3发布的地图服务，也可以通过继承相应的图层，引入其他的数据源，比如ArcGIS Server9.2发布的地图服务，WMS服务，或者其他免费的数据。本节就通过一个实例，来看看如何将Google Map作为底图数据。
        Google Map是经过缓存的数据，所以需要继承的是TiledMapServiceLayer。那么在扩展这个图层的时候需要做哪些工作呢？首先就要明白地图缓存的原理。可以看出我们继承的这个图层，需要收集到以下几个信息：
1、Tiling Scheme Origin；
2、切图的范围，也就是FullExtent；
3、SpatialReference；
4、TileInfo，包括切图的大小，级数，以及每级的Resolution；
5、最后就是重写GetTileUrl方法。
 
  
   这是为什么呢？可以想象，当地图控件的范围改变时，能够获取到当前范围的信息，那么只要把左上角和右下角之间的Tile全部按顺序显示出来就行了。
由前面的文章可以看出，当图层获取了1、2、3、4四个信息后，图层完全可以自动计算出所需的Tile，最后根据GetTileUrl方法取回这些
Tile显示出来即可。
        那么对于Google
Map的前4个参数，如何取得呢？记得在Catalog中做缓存时，有一个LoadTiling Scheme from Google
Map吗？按照这个TilingScheme将一个地图服务做缓存，然后查看它的conf.xml和ServiceDirectory，便完全可以取得这
几个参数了。另外关于如何获取Google Map的缓存，网上已经有非常多方法，这里就不再讨论了。

ArcGIS API for Silverlight开发入门

ArcGIS API for Silverlight开发入门

代码如下：

  1. public class GoogleMap:TiledMapServiceLayer
  2. {
  3. public override void Initialize()
  4. {
  5. this.FullExtent = new
  6. ESRI.ArcGIS.Geometry.Envelope(-20037508.342787,-20037508.342787,20037508.342787,20037508.342787);//(-180,
  7. -85.0511287798066,180, 85.0511287798066)
  8. {
  9. SpatialReference = new ESRI.ArcGIS.Geometry.SpatialReference(102113);
  10. };
  11. this.SpatialReference = new ESRI.ArcGIS.Geometry.SpatialReference(102113);
  12. //this.InitialExtent = this.FullExtent;
  13. this.TileInfo = new TileInfo()
  14. {
  15. Height = 256,
  16. Width = 256,
  17. Origin = new ESRI.ArcGIS.Geometry.MapPoint(-20037508.342787,
  18. 20037508.342787)//Origin = new ESRI.ArcGIS.Geometry.MapPoint(-180, 90)
  19. {
  20. SpatialReference = new ESRI.ArcGIS.Geometry.SpatialReference(102113)
  21. },
  22. Lods = new Lod[20]
  23. };
  24. double resolution = 156543.033928;
  25. for (int i = 0; i < TileInfo.Lods.Length; i++)
  26. {
  27. TileInfo.Lods[i] = new Lod() { Resolution = resolution };
  28. resolution /= 2;
  29. }
  30. base.Initialize();
  31. }
  32. public override string GetTileUrl(int level, int row, int col)
  33. {
  34. //google maps map
  35. //string baseUrl = "http://mt0.google.com/mt/v=ap.92&hl=zh-CN&x=";
  36. //string url = baseUrl + col.ToString() + "&y=" + row.ToString() + "&z=" + level.ToString() + "&s=";
  37. //return url;
  38. ////google maps satallite
  39. string baseUrl = "http://khm2.google.com/kh/v=38&hl=zh-CN&x=";
  40. string url = baseUrl + col.ToString() + "&y=" + row.ToString() + "&z=" + level.ToString() + "&s=";
  41. return url;
  42. }
  43. }

复制代码

需要注意一点，Google Map采用的是WGS 1984 Web
Mercator投影，这个投影的wkid在RESTAPI中查不到，但在ServiceDirecotry中可以找到，是102113。另外，重写
DynamicMapServiceLayer也是基本相同的。
        之后也可以按照这个Tiling
Scheme对自己的服务作缓存，自己的数据和Google
Map便可以叠加在一起了。但是这样子使用GoogleMap的数据不仅担心会被封IP，而且更重要的是版权问题，毕竟不像JS API（有ArcGIS
JavaScript Extension forthe Google Maps API ）或者Flex API（有Google Map API
forFlex）。别忘了MS有自己的Virtual Earth，下一节中就来看看如何在我们的程序中名正言顺的使用VE的数据吧。

原文地址:http://bbs.esrichina-bj.cn/ESRI/thread-45582-1-1.html

  SilverlightAPI中还包括了一个ESRI.ArcGIS.VirtualEarth.dll类库，让我们可以方便的访问到老东家的 VirtualEarth服务。目前SilverlightAPI中提供的VirtualEarth服务有三种：Map，Geocode和 Routing，不过一看就知道后两种服务对于国内的数据来说又无缘了。
        直接看如何使用它的Map服务获取地图数据吧。同前，新建一个Silverlight工程，添加ESRI.ArcGIS.dll和ESRI.ArcGIS.VirtualEarth.dll的引用，引入xml命名空间，在xaml里面这样写：
  1. <esri:Map x:Name="Map1" Loaded="Map1_Loaded">
  2. <esri:Map.Layers>
  3. <esriVE:TileLayer ID="VELayer" LayerStyle="AerialWithLabels" ServerType="Staging"/>
  4. </esri:Map.Layers>
  5. </esri:Map>

复制代码

可
以看出，和添加其他图层基本是一样的。SIlverlightAPI中针对VE地图的图层类型是TileLayer，LayerStyle有三
种：Road，Aerial和AerialWithLabels，分别对应矢量图，影像图和带街道标注的影像图。ServerType就比较特殊了，有两
种：Staging和Production，分别对应访问VE服务的账户类别，前者是免费的，后者是收费的。如果你此时运行程序的话，那是看不到地图的，
因为TileLayer还有个关键的token属性没有设置。
    
   VE的服务那是相当安全，每次访问VE的服务，都要提供一个token（一个加密字符串）来进行身份验证，而这个token又是根据
TokenService自动生成的，要通过TokenService生成一个token，又需要一个合法的Microsoft Virtual
Earth Platformdeveloper account……明白了这个过程，就来做我们的工作吧。
        首先，去申请一个Microsoft Virtual Earth Platform developer account,当然之前你还得有一个Windows Live账号。申请的这个账号是Evaluation版的，所以决定了以后我们只能使用Staging的服务，如果要把它变成Production版本，可以通过邮件联系微软，然后缴费；
 
      之后到注册时所填的邮箱去激活申请的Microsoft Virtual Earth Platform
developeraccount账号，然后为其设置密码（必须是8-14为之间，包括大、小写字母，数字，且还要有非字母数字的字符，和windows
server2008是一样的），我们平常肯定不会这样设置密码，为了以防万一，建议赶紧把设置好的密码记录下来，
没准哪天就忘了。现在就可以用这个账户和密码来访问TokenService，通过它生成token，交给TileLayer的token属性。
 
  
   为了安全目的考虑，token是不建议也不能直接在Silverlight程序中进行设置的。那么怎么办呢？这样办：1、通过装载
Silverlight的aspx页面的Page_Load方法，来申请我们的token，并把它添加到Silverlight的初始参数中，2、然后当
Silverlight插件载入的时候，把token读出来，3、在Map_Loaded事件中，赋给TileLayer。
1、通过TokenService申请token：
在webapp中add webreference，url用https://staging.common.virtualearth.net/find-30/common.asmx?wsdl，起个名字叫VirtualEarthService.TokenService。

  1. <script language="C#" runat="Server">
  2. private string VEAccountID = "你的ID（注意只是AccountID）";
  3. private string VEAccountPassword="你的密码";
  4. protected void Page_Load(object sender,EventArgs e)
  5. {
  6. _08_virtual_earth.Web.VirtualEarthService.TokenService.CommonService
  7. commenservice = new
  8. _08_virtual_earth.Web.VirtualEarthService.TokenService.CommonService();
  9. commenservice.Credentials = new System.Net.NetworkCredential(VEAccountID, VEAccountPassword);
  10. _08_virtual_earth.Web.VirtualEarthService.TokenService.TokenSpecification
  11. tokenSpec=new
  12. _08_virtual_earth.Web.VirtualEarthService.TokenService.TokenSpecification();
  13. tokenSpec.TokenValidityDurationMinutes=480;
  14. if (HttpContext.Current!=null && !HttpContext.Current.Request.IsLocal)
  15. {
  16. tokenSpec.ClientIPAddress=HttpContext.Current.Request.UserHostAddress;
  17. }
  18. else
  19. {
  20. tokenSpec.ClientIPAddress="127.0.0.1";
  21. }
  22. string token = "";
  23. token = commenservice.GetClientToken(tokenSpec);
  24. Xaml1.InitParameters = string.Format("token={0}", token);
  25. }
  26. </script>

复制代码

其中Xaml1是Silverlight插件的ID：<asp:Silverlight ID="Xaml1" runat="server"...
2、Silverlight插件载入时读出这个token。在App.xaml.cs中：

  1. private void Application_Startup(object sender, StartupEventArgs e)
  2. {
  3. VEtoken = e.InitParams["token"];
  4. this.RootVisual = new Page();
  5. }

复制代码

3、最后在加载地图控件后，交付token：

  1. private void Map1_Loaded(object sender, RoutedEventArgs e)
  2. {
  3. foreach (Layer layer in Map1.Layers)
  4. if (layer is TileLayer)
  5. (layer as TileLayer).Token = (Application.Current as App).VEtoken;
  6. }

复制代码

终于能看见VE的图了。当然，我们的开发账户是免费的，所以地图上有很多“Staging”麻点（每个tile一个）：

ArcGIS API for Silverlight开发入门

至此，ArcGIS API for
Silverlight的开发入门已经讲完了，我和大家一样也是边学边写的，刚好这两天SIlverlightAPI又升级了第二个Beta版。其实
Silverlight和Flex一样，能使传统的WebGIS散发出全新的魅力，从而使我们的程序在RIA的道路上大踏步前进，能够做出什么样的效果也
基本只受想象力的制约了。随着Silverlight3的推出，我们也有理由相信Silverlight的明天会更好。

原文地址:http://bbs.esrichina-bj.cn/ESRI/thread-45835-1-1.html

相关文章