Implement this class if you want to create a custom dynamic layer where the generated image can be reached by a URL to a service of file hosted online. Note that if you want to manipulate the image, generate it on the client or manually handle download of the image you should instead implement DynamicLayer.

As a minimum this layer must implement GetUrl and set the Layer.FullExtent to the extent of the layer. The FullExtent should include a default SpatialReference for the layer. The map uses this to determine when to draw the layer.

When overriding Layer.Initialize you should always call base.Initialize(). If you require doing an asynchronous request (ie download metadata about the service), you should call base.Initialize() after the processing has completed. The Map wil not render the layer until Initialize has been called. If an error occurs in initialization set the Layer.InitializationFailure property with the exception and still call base.Initialize() afterwards.

Creating a dynamic layer using a simple map rendering webservice:

            public class MyLayer : DynamicMapServiceLayer
            {
              public override void Initialize()
              {
                this.FullExtent = new Envelope(-180,-90,180,80) { SpatialReference = new SpatialReference(4326) };
                this.SpatialReference = new SpatialReference(4326);
                base.Initialize();
              }
              public override void GetUrl(Envelope extent, int width, int height, OnUrlComplete onComplete)
              {
                if (extent.SpatialReference != null && extent.SpatialReference.WKID != 4326)
                  throw new NotSupportedException("SRID not supported");
                onComplete(string.Format(CultureInfo.InvariantCulture, "http://myserver/service.ashx?box={0},{1},{2},{3}&w={4}&h={5}",
                  extent.XMin, extent.YMin, extent.XMax, extent.YMax, width, height),
                  width, height, extent);
              }
            }
            

System.Object
   System.Windows.DependencyObject
      ESRI.ArcGIS.Client.Layer
         ESRI.ArcGIS.Client.DynamicLayer
            ESRI.ArcGIS.Client.DynamicMapServiceLayer
               ESRI.ArcGIS.Client.ArcGISDynamicMapServiceLayer
               ESRI.ArcGIS.Client.ArcGISImageServiceLayer
               ESRI.ArcGIS.Client.Tasks.GPResultImageLayer
               ESRI.ArcGIS.Client.Toolkit.DataSources.WmsLayer

Target Platforms: Windows Vista, Windows 7

Reference