Visual Basic (Declaration) | |
---|---|
Public Property DynamicLayerInfos As DynamicLayerInfoCollection |
C# | |
---|---|
public DynamicLayerInfoCollection DynamicLayerInfos {get; set;} |
Dynamic Layers allow the execution of various ArcGIS Server requests from a client application. An in-depth discussion about Dynamic Layers is in the ArcGISDynamicMapServiceLayer Class documentation. The client side requests that can be issued to ArcGIS Server include the ability to:
- Change the rendering of an existing ArcGISDynamicMapServiceLayer. See the code examples in this document, the ArcGISDynamicMapServiceLayer.CreateDynamicLayerInfosFromLayerInfos Method, and the LayerDrawingOptionsCollection Class.
- Create a layer on-the-fly for the Workspace Types of: Database, Shapefile, FileGDB, and Raster. See the code examples in this document and the DynamicLayerInfoCollection Class.
- Perform table joins.
- Query for specific records.
- Identify features.
- Return raster images.
Dynamic Layers are new in ArcGIS Server v10.1 and require the ArcGIS API 3.0 for Silverlight and higher.
The key to creating a Dynamic Layer is to set the DynamicLayerInfo.Source Property to the appropriate LayerSource object. The LayerSource is an Abstract Class and has two inherited Classes that should be used in setting the DynamicLayerInfo.Source, they are: LayerDataSource and LayerMapSource (review the 'LayerSource Digression' topic section in the ArcGISDynamicMapServiceLayer Class documentation for a more in-depth discussion). One DynamicLayerInfo object is used per Dynamic Layer and is added to a DynamicLayerInfoCollection which is set to the ArcGISDynamicMapServiceLayer.DynamicLayerInfos Property. By default, an ArcGISDynamicMapServiceLayer that was created in ArcMap and served up via ArcGIS Server has its DynamicLayerInfos collection being empty (meaning Nothing/null). Developers can use the ArcGISDynamicMapServiceLayer.CreateDynamicLayerInfosFromLayerInfos Method to populate the DynamicLayerInfoCollection to serve as a starting point for creating a Dynamic Layer or they can create individual DynamicLayerInfo objects from scratch and add them to the DynamicLayerInfoCollection.
The collection of DynamicLayerInfo objects is used to change the Layer ordering or to redefine the Dynamic Layers drawn in the Map. The order of the objects in the DynamicLayerInfoCollection defines the Layer drawing order; specifically the first element of the collection draws on top of all other Layers.
How to use:
When the application starts a Dynamic Layer (Black lines) is added to the Map Control via XAML. Click the button to add another Dynamic Layer (Red solid circles) via code-behind. The Dynamic Layers used in this example code are based upon using a LayerDataSource that is undiscoverable via the public ArcGIS Server Directory REST pages. The 'WorkspaceID' and 'DataSourceName' for each Dynamic Layer must be provided to the developer by Manager/Adminstrator of the ArcGISDynamicMapServiceLayer. Examples of the 'WorkspaceID' and 'DataSourceName' are provided as comments in the XAML and code-behind for a public ArcGIS Server that has Dynamic Layers enabled via the LayerDataSource object.
The XAML code in this example is used in conjunction with the code-behind (C# or VB.NET) to demonstrate the functionality.
The following screen shot corresponds to the code example in this page.
XAML | Copy Code |
---|---|
<Grid x:Name="LayoutRoot"> <!-- Add a Map Control. Set the Extent to the Continental United States. --> <esri:Map Background="White" HorizontalAlignment="Left" Margin="0,180,0,0" Name="Map1" VerticalAlignment="Top" Height="350" Width="500" Extent="-14070971,2468307,-7345298,6748281"> <!--Add a backdrop ArcGISTiledMapServiceLayer. --> <esri:ArcGISTiledMapServiceLayer ID="myArcGISTiledMapServiceLayer" Url="http://services.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer" /> <!-- Add a Layer on-the-fly based on an ArcGISDynamicMapServiceLayer that has Dynamic Layer capabalities enabled. The Layer being added DOES NOT come from an existing sub-layer in a LayerMapSource. Rather the Dynamic Layer is being generated uses the 'Workspace Type' of 'File GDB' via the LayerDataSource object. Review the ESRI.ArcGIS.Client.ArcGISDynamicMapServiceLayer Class documentation in the API reference for a full discussion. In order to create this Dynamic Layer, information was shared between the Manager/Admininstrator of the ArcGISDynamicMapServiceLayer ArcGIS Server service and the application developer. The Url for the ArcGISDynamicMapServiceLayer is: "http://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer". The WorkspaceID used in the LayerDataSource for the Dynamic Layer is: "CensusFileGDBWorkspaceID" There are several DataSourceName types associated with the WorkspaceID that could be used to create the Rendering of a Dynamic Layer. Think of the DataSourceName as the string name of the layer that will be drawn dynamically. A listing of the available DataSourceNames (and their geometry type) are: "cities" <== Points "counties" <== Polygons "highways" <== Polylines "lakes" <== Polygons "states" <== Points Note: the DisableClientCaching is set to true so that what ever is returned from the server will be displayed. The following high-level things are occuring to create the Dynamic Layer: (1) create a DynamicLayerInfo object and set the .ID and .Source Properties (2) add that DynamicLayerInfo object to the ArcGISDynamicMapServiceLayer .DynamicLayerInfos collection (3) create a LayerDrawingOptions object and set the .LayerID and .Renderer Properties (4) add that LayerDrawingOptions object to the ArcGISDynamicMapServiceLayer .LayerDrawingOptions collection --> <esri:ArcGISDynamicMapServiceLayer Url="http://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer" DisableClientCaching="True"> <esri:ArcGISDynamicMapServiceLayer.DynamicLayerInfos> <esri:DynamicLayerInfoCollection> <esri:DynamicLayerInfo ID="101"> <esri:DynamicLayerInfo.Source> <esri:LayerDataSource> <esri:LayerDataSource.DataSource> <esri:TableDataSource WorkspaceID="CensusFileGDBWorkspaceID" DataSourceName="highways"/> </esri:LayerDataSource.DataSource> </esri:LayerDataSource> </esri:DynamicLayerInfo.Source> </esri:DynamicLayerInfo> </esri:DynamicLayerInfoCollection> </esri:ArcGISDynamicMapServiceLayer.DynamicLayerInfos> <esri:ArcGISDynamicMapServiceLayer.LayerDrawingOptions> <esri:LayerDrawingOptionsCollection> <esri:LayerDrawingOptions LayerID="101" > <esri:LayerDrawingOptions.Renderer> <esri:SimpleRenderer> <esri:SimpleLineSymbol Color="Black" Width="3" Style="Solid" /> </esri:SimpleRenderer> </esri:LayerDrawingOptions.Renderer> </esri:LayerDrawingOptions> </esri:LayerDrawingOptionsCollection> </esri:ArcGISDynamicMapServiceLayer.LayerDrawingOptions> </esri:ArcGISDynamicMapServiceLayer> </esri:Map> <!-- Button to add a Dynamic Layer (using LayerDataSource) via code-behind. --> <Button Content="Add a Dynamic Layer using a LayerDataSource" Height="23" HorizontalAlignment="Left" Margin="0,151,0,0" Name="Button1" VerticalAlignment="Top" Width="500" Click="Button1_Click"/> <!-- Provide the instructions on how to use the sample code. --> <TextBlock Height="145" HorizontalAlignment="Left" Name="TextBlock1" VerticalAlignment="Top" Width="788" TextWrapping="Wrap" Text="When the application starts a Dynamic Layer (Black lines) is added to the Map Control via XAML. Click the button to add another Dynamic Layer (Red solid circles) via code-behind. The Dynamic Layers used in this example code are based upon using a LayerDataSource that is undiscoverable via the public ArcGIS Server Directory REST pages. The 'WorkspaceID' and 'DataSourceName' for each Dynamic Layer must be provided to the developer by Manager/Adminstrator of the ArcGISDynamicMapServiceLayer. Examples of the 'WorkspaceID' and 'DataSourceName' are provided as comments in the XAML and code-behind for a public ArcGIS Server that has Dynamic Layers enabled via the LayerDataSource object."/> </Grid> |
C# | Copy Code |
---|---|
private void Button1_Click(object sender, System.Windows.RoutedEventArgs e) { // Add a Layer on-the-fly based on an ArcGISDynamicMapServiceLayer that has Dynamic Layer capabalities enabled. // The Layer being added DOES NOT come from an existing sub-layer in a LayerMapSource. Rather the Dynamic Layer // is being generated uses the 'Workspace Type' of 'File GDB' via the LayerDataSource object. Review the // ESRI.ArcGIS.Client.ArcGISDynamicMapServiceLayer Class documentation in the API reference for a full discussion. // In order to create this Dynamic Layer, information was shared between the Manager/Admininstrator of the // ArcGISDynamicMapServiceLayer ArcGIS Server service and the application developer. // // The Url for the ArcGISDynamicMapServiceLayer is: "http://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer". // // The WorkspaceID used in the LayerDataSource for the Dynamic Layer is: "CensusFileGDBWorkspaceID" // // There are several DataSourceName types associated with the WorkspaceID that could be used to create the Rendering // of a Dynamic Layer. Think of the DataSourceName as the string name of the layer that will be drawn dynamically. // A listing of the available DataSourceNames (and their geometry type) are: // "cities" <== Points // "counties" <== Polygons // "highways" <== Polylines // "lakes" <== Polygons // "states" <== Points // Create a new TableDataSource object and set it's .WorkspaceID and .DataSourceName Properties to valid values. ESRI.ArcGIS.Client.TableDataSource myTableDataSource = new ESRI.ArcGIS.Client.TableDataSource(); myTableDataSource.WorkspaceID = "CensusFileGDBWorkspaceID"; myTableDataSource.DataSourceName = "cities"; // Create a new LayerDataSource and set its DataSource Property to the TableDataSource. ESRI.ArcGIS.Client.LayerDataSource myLayerDataSource = new ESRI.ArcGIS.Client.LayerDataSource(); myLayerDataSource.DataSource = myTableDataSource; // Create a new DynamicLayerInfo object and set its ID and Source Properties. ESRI.ArcGIS.Client.DynamicLayerInfo myDynamicLayerInfo = new ESRI.ArcGIS.Client.DynamicLayerInfo(); myDynamicLayerInfo.ID = 102; // Must be the same as the LayerDrawingOptions.LayerID myDynamicLayerInfo.Source = myLayerDataSource; // Create a new DynamicLayerInfoCollection and add the DynamicLayerInfo object into it. ESRI.ArcGIS.Client.DynamicLayerInfoCollection myDynamicLayerInfoCollection = new ESRI.ArcGIS.Client.DynamicLayerInfoCollection(); myDynamicLayerInfoCollection.Add(myDynamicLayerInfo); // Create a SimpleMarkerSymbol and sets it Style to a circle, Color to Red, and Size to 10 points. ESRI.ArcGIS.Client.Symbols.SimpleMarkerSymbol mySimpleMarkerSymbol = new ESRI.ArcGIS.Client.Symbols.SimpleMarkerSymbol(); mySimpleMarkerSymbol.Style = ESRI.ArcGIS.Client.Symbols.SimpleMarkerSymbol.SimpleMarkerStyle.Circle; mySimpleMarkerSymbol.Color = new System.Windows.Media.SolidColorBrush(Colors.Red); mySimpleMarkerSymbol.Size = 10; // Create a new SimpleRenderer based upon the SimpleMarkerSymbol. ESRI.ArcGIS.Client.SimpleRenderer mySimpleRenderer = new ESRI.ArcGIS.Client.SimpleRenderer(); mySimpleRenderer.Symbol = mySimpleMarkerSymbol; // Create a new LayerDrawingOptions object which is key to applying our custom Rendering of the Dynamic Layer. // It is imperative that the LayerDrawingOptions.LayerID = DynamicLayerInfo.ID so that the Dynamic Layer draws // using the new symbology. ESRI.ArcGIS.Client.LayerDrawingOptions myLayerDrawingOptions = new ESRI.ArcGIS.Client.LayerDrawingOptions(); myLayerDrawingOptions.LayerID = 102; // Must be the same as the DynammicLayerInfo.ID myLayerDrawingOptions.Renderer = mySimpleRenderer; // Create a new LayerDrawinOptionsCollection and add the LayerDraingOptions object into it. ESRI.ArcGIS.Client.LayerDrawingOptionsCollection myLayerDrawingOptionsCollection = new ESRI.ArcGIS.Client.LayerDrawingOptionsCollection(); myLayerDrawingOptionsCollection.Add(myLayerDrawingOptions); // Create a new Dynamic Layer that is based upon on a LayerDataSource of an ArcGISDynamicMapServiceLayer // and apply it's custom rendering. ESRI.ArcGIS.Client.ArcGISDynamicMapServiceLayer myArcGISDynamicMapServiceLayer = new ESRI.ArcGIS.Client.ArcGISDynamicMapServiceLayer(); myArcGISDynamicMapServiceLayer.Url = "http://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer"; myArcGISDynamicMapServiceLayer.DisableClientCaching = true; myArcGISDynamicMapServiceLayer.DynamicLayerInfos = myDynamicLayerInfoCollection; myArcGISDynamicMapServiceLayer.LayerDrawingOptions = myLayerDrawingOptionsCollection; // Because ArcGIS Server restricts only 1000 features being returned per request (this is set as the default // unless it is overridden by the ArcGIS Server Manager/Admininstrator), we will apply a LayerDefinition // where clause to restrict the amount of features that are returned. This block of code would not be necessary // if your service allowed unlimited features being returned per request or your services did not have more than // 1000 features to display. ESRI.ArcGIS.Client.LayerDefinition myLayerDefinition = new ESRI.ArcGIS.Client.LayerDefinition(); myLayerDefinition.Definition = "POP2000 > 100000"; myLayerDefinition.LayerID = 102; myArcGISDynamicMapServiceLayer.LayerDefinitions.Add(myLayerDefinition); // Add the Dynamic Layer to the Map Control. This causes the round trip server request to occur. Map1.Layers.Add(myArcGISDynamicMapServiceLayer); } |
VB.NET | Copy Code |
---|---|
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.Windows.RoutedEventArgs) ' Add a Layer on-the-fly based on an ArcGISDynamicMapServiceLayer that has Dynamic Layer capabalities enabled. ' The Layer being added DOES NOT come from an existing sub-layer in a LayerMapSource. Rather the Dynamic Layer ' is being generated uses the 'Workspace Type' of 'Database' via the LayerDataSource object. Review the ' ESRI.ArcGIS.Client.ArcGISDynamicMapServiceLayer Class documentation in the API reference for a full discussion. ' In order to create this Dynamic Layer, information was shared between the Manager/Admininstrator of the ' ArcGISDynamicMapServiceLayer ArcGIS Server service and the application developer. ' ' The Url for the ArcGISDynamicMapServiceLayer is: "http://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer". ' ' The WorkspaceID used in the LayerDataSource for the Dynamic Layer is: "CensusFileGDBWorkspaceID" ' ' There are several DataSourceName types associated with the WorkspaceID that could be used to create the Rendering ' of a Dynamic Layer. Think of the DataSourceName as the string name of the layer that will be drawn dynamically. ' A listing of the available DataSourceNames (and their geometry type) are: ' "cities" <== Points ' "counties" <== Polygons ' "highways" <== Polylines ' "lakes" <== Polygons ' "states" <== Points ' Create a new TableDataSource object and set it's .WorkspaceID and .DataSourceName Properties to valid values. Dim myTableDataSource As New ESRI.ArcGIS.Client.TableDataSource myTableDataSource.WorkspaceID = "CensusFileGDBWorkspaceID" myTableDataSource.DataSourceName = "cities" ' Create a new LayerDataSource and set its DataSource Property to the TableDataSource. Dim myLayerDataSource As New ESRI.ArcGIS.Client.LayerDataSource myLayerDataSource.DataSource = myTableDataSource ' Create a new DynamicLayerInfo object and set its ID and Source Properties. Dim myDynamicLayerInfo As New ESRI.ArcGIS.Client.DynamicLayerInfo myDynamicLayerInfo.ID = 102 ' Must be the same as the LayerDrawingOptions.LayerID myDynamicLayerInfo.Source = myLayerDataSource ' Create a new DynamicLayerInfoCollection and add the DynamicLayerInfo object into it. Dim myDynamicLayerInfoCollection As New ESRI.ArcGIS.Client.DynamicLayerInfoCollection myDynamicLayerInfoCollection.Add(myDynamicLayerInfo) ' Create a SimpleMarkerSymbol and sets it Style to a circle, Color to Red, and Size to 10 points. Dim mySimpleMarkerSymbol As New ESRI.ArcGIS.Client.Symbols.SimpleMarkerSymbol mySimpleMarkerSymbol.Style = ESRI.ArcGIS.Client.Symbols.SimpleMarkerSymbol.SimpleMarkerStyle.Circle mySimpleMarkerSymbol.Color = New System.Windows.Media.SolidColorBrush(Colors.Red) mySimpleMarkerSymbol.Size = 10 ' Create a new SimpleRenderer based upon the SimpleMarkerSymbol. Dim mySimpleRenderer As New ESRI.ArcGIS.Client.SimpleRenderer mySimpleRenderer.Symbol = mySimpleMarkerSymbol ' Create a new LayerDrawingOptions object which is key to applying our custom Rendering of the Dynamic Layer. ' It is imperative that the LayerDrawingOptions.LayerID = DynamicLayerInfo.ID so that the Dynamic Layer draws ' using the new symbology. Dim myLayerDrawingOptions As New ESRI.ArcGIS.Client.LayerDrawingOptions myLayerDrawingOptions.LayerID = 102 ' Must be the same as the DynammicLayerInfo.ID myLayerDrawingOptions.Renderer = mySimpleRenderer ' Create a new LayerDrawinOptionsCollection and add the LayerDraingOptions object into it. Dim myLayerDrawingOptionsCollection As New ESRI.ArcGIS.Client.LayerDrawingOptionsCollection myLayerDrawingOptionsCollection.Add(myLayerDrawingOptions) ' Create a new Dynamic Layer that is based upon on a LayerDataSource of an ArcGISDynamicMapServiceLayer ' and apply it's custom rendering. Dim myArcGISDynamicMapServiceLayer As New ESRI.ArcGIS.Client.ArcGISDynamicMapServiceLayer myArcGISDynamicMapServiceLayer.Url = "http://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer" myArcGISDynamicMapServiceLayer.DisableClientCaching = True myArcGISDynamicMapServiceLayer.DynamicLayerInfos = myDynamicLayerInfoCollection myArcGISDynamicMapServiceLayer.LayerDrawingOptions = myLayerDrawingOptionsCollection ' Because ArcGIS Server restricts only 1000 features being returned per request (this is set as the default ' unless it is overridden by the ArcGIS Server Manager/Admininstrator), we will apply a LayerDefinition ' where clause to restrict the amount of features that are returned. This block of code would not be necessary ' if your service allowed unlimited features being returned per request or your services did not have more than ' 1000 features to display. Dim myLayerDefinition As New ESRI.ArcGIS.Client.LayerDefinition myLayerDefinition.Definition = "POP2000 > 100000" myLayerDefinition.LayerID = 102 myArcGISDynamicMapServiceLayer.LayerDefinitions.Add(myLayerDefinition) ' Add the Dynamic Layer to the Map Control. This causes the round trip server request to occur. Map1.Layers.Add(myArcGISDynamicMapServiceLayer) End Sub |
Target Platforms: Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family, Windows 7