Layer.EnableStyle Method
Enables or disables a named style for the layer.
EnableStyle(System.String style, System.Boolean enable)
Enables or disables a named style for the layer.Syntax
public void EnableStyle (
System.String style,
System.Boolean enable
)Parameters
The name of the style.
True to enable the style, False to disable it.
Remarks
This method works differently depending on the type of layer.
For OgcWmsServerLayer and OgcWmtsServerLayer, enabling or disabling a style will modify subsequent requests sent to the WMS or WMTS server, requesting the server to enable or disable the style. The WMS and WMTS standards only support one style per layer, so enabling one style will automatically disable any previously enabled style.
For all other types of layer except CatalogLayer, enabling or disabling a style will set or remove an update attribute that will be propagated to operators, visualizers and datasets when the layer is updated. The name of the attribute will be NamedStyle_<style>, and the value True. For backwards compatibility, the attribute CatalogStyle_<style> will also be set. The operators, visualizers and datasets may use this update attribute to implement the style, for instance by selecting different color schemes if the update attribute is present or not. Note that update attributes are passed down to child layers during an update; setting a style on a LayerSet may affect all its child layers.
If this method is called for a CatalogLayer, it will simply enable or disable the style on its corresponding internal layer.
You can find out which styles a layer recognizes with the NamedStyles property.
Example
// Enable first available NamedStyle
public static void EnableFirstAvailableNamedStyle(Layer layer)
{
// Get the firs NamedStyle from the Layer
NamedStyle firstNamedStyle = layer.NamedStyles[0];
// Enable the NamedStyle at the Layer
layer.EnableStyle(firstNamedStyle.Name, true);
}
Platforms
Windows, Linux, Android