<!– Class –> Represents an object that encapsulates a Web Map Service (WMS) source.

A Web Map Service (WMS) produces maps of spatially referenced data dynamically from geographic information. This international standand defines a “map” as a portrayal of geographic information as a digital image file suitable for display on a computer screen.

A map is not the the data itself. WMS-produced maps are generally rendered in a pictorial format such as PNG or JPEG, or occasionally as vector-based graphical elements in Scalable Vector Graphics (SVG) or Web Computer Graphics Metafile (WebCGM) formats.

*System.Object ThinkGeo.MapSuite.Core.RasterSource *ThinkGeo.MapSuite.Core.WmsRasterSource

This is the constructor for the class. If you use this constructor, then you need to set the required properties manually.

This is the default constructor.

Go Back

This is the constructor the for the class.

This constructor initializes a new WmsRasterSource and downloads and parses the service description. In an ASP.NET application, the service description is automatically cached for 24 hours when it is not specified.

Go Back

This is the constructor the for the class.

This constructor initializes a new WmsRasterSource and downloads and parses the service description In an ASP.NET application, the service description is automatically cached for 24 hours when it is not specified.

Go Back

Create a copy of RasterSource using the deep clone process.

The difference between deep clone and shallow clone is: when shallow cloned, only the object is copied, but the contained objects are not; while in deep clone it does copy the cloned object as well as all the objects within.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This method closes the RasterSource and releases any resources it was using.

This method is the concrete wrapper for the abstract method CloseCore. The Close method plays an important role in the life cycle of the RasterSource. It may be called after drawing to release any memory and other resources that were allocated since the Open method was called.

If you override the Core version of this method, it is recommended that you take the following things into account: This method may be called multiple times, so we suggest you write the method so that that a call to a closed RasterSource is ignored and does not generate an error. We also suggest that in the Close you free all resources that have been opened. Remember that the object will not be destroyed, but will be re-opened possibly in the near future.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

<!– System.Object –> Go Back

<!– static –> This method returns a string that represents the image's world file based on the parameters passed in.

This method returns a string that represents the image's world file. The world file is a file type that can accompany image files. It contains information about the image's position, resolution and other spatial-related items. It is common to have this kind of file associated with generic image types such as JPG, BMP, and normal TIFF because they do not have a mechanism to store this data internally. Modern GIS image types such as JPEG2000, ECW, and MrSid typically have this information stored internally. We provide this method in the event that you want to create your own world file from any image that either already has one or has its data stored internally.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This method returns the bounding box of the RasterSource.

This method returns the bounding box of the RasterSource.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

<!– System.Object –> Go Back

This method returns the horizontal resolution of the image.

This method returns the horizontal resolution of the image.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This method returns an image based on the worldExtent and image width and height.

This method is responsible for returning the image based on the parameters passed in. As the core version of this method is abstract, you will need to override it when creating your own RasterSource.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This method returns the height of the image in screen coordinates.

This method returns the height of the image in screen coordinates.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This method returns the width of the image in screen coordinates.

This method returns the width of the image in screen coordinates.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This method returns the projection text in proj4 format.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

Get the request URL from the client to the WMS.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This API gets the GetCapabilites document of the service.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This method returns the projected or geographic coordinate reference systems to be used.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This method returns the exception format at the server side.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This API gets the WMS server FeatureInfo formats of the service.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This method returns the names of all layers at the server side.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This method returns the output format at the server side.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This method returns the names of all styles at the server side.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This API gets the WMS server version of the service.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

<!– System.Object –> Go Back

This method returns the vertical resolution of the image.

This method returns the vertical resolution of the image.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This method returns a string that represents the image's world file.

This method wraps the Core version of this method and returns a string that represents the image's world file. The world file is a file type that can accompany image files. It contains information about the image's position, resolution and other spatial-related items. It is common to have this kind of file associated with generic image types such as JPG, BMP, and normal TIFF because they do not have a mechanism to store this data internally. Modern GIS image types such as JPEG2000, ECW, and MrSid typically have this information stored internally. We provide this method in the event that you want to create your own world file from any image that either already has one or has its data stored internally.

As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This method opens the RasterSource so that it is initialized and ready to use.

This method is the concrete wrapper for the abstract method OpenCore. The Open method plays an important role, as it is responsible for initializing the RasterSource. Most methods on the RasterSource will throw an exception if the state of the RasterSource is not opened. When the map draws each layer, it will open the RasterSource as one of its first steps; then, after it is finished drawing with that layer, it will close it. In this way, we are sure to release all resources used by the RasterSource.

When implementing the abstract method, consider opening files for file-based sources, connecting to databases in the database-based sources and so on. You will get a chance to close these in the Close method of the RasterSource. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

<!– System.Object –> Go Back

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

Create a copy of RasterSource using the deep clone process. The default implementation uses serialization.

The difference between deep clone and shallow clone is: when shallow cloned, only the object is copied, but the contained objects are not; while in deep clone it does copy the cloned object as well as all the objects within.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

<!– ThinkGeo.MapSuite.Core.RasterSource(overriden) –> Go Back

<!– System.Object –> Go Back

This method returns the bounding box of the RasterSource.

This method returns the bounding box of the RasterSource.

<!– ThinkGeo.MapSuite.Core.RasterSource(overriden) –> Go Back

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This method returns an image based on the worldExtent and image width and height.

This method is responsible for returning the image based on the parameters passed in. As the core version of this method is abstract, you will need to override it when creating our own RasterSource.

<!– ThinkGeo.MapSuite.Core.RasterSource(overriden) –> Go Back

This method returns the height of the image in screen coordinates.

This virtual method is called from the concrete method GetImageHeight. It returns the height of the image in screen coordinates.

<!– ThinkGeo.MapSuite.Core.RasterSource(overriden) –> Go Back

This method returns the width of the image in screen coordinates.

This virtual method is called from the concrete method GetImageWidth. It returns the width of the image in screen coordinates.

<!– ThinkGeo.MapSuite.Core.RasterSource(overriden) –> Go Back

This method returns the projection text in proj4 format.

This protected virtual method is called from the concrete public method GetProjectionText.

The default implementation of this core method is to throw an exception. So you need to overwrite this method to return the RasterSource projection text.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

<!– System.Object –> Go Back

This method allows you to raise the ClosedRasterSource event from a derived class.

You can call this method from a derived class to enable it to raise the ClosedRasterSource event. This may be useful if you plan to extend the RasterSource and you need access to the event.

Details on the event:

This event is called after the closing of the RasterSource. Technically, this event is called after the calling of the Close method on the RasterSource and after the protected CloseCore method.

It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This method allows you to raise the ClosingRasterSource event from a derived class.

You can call this method from a derived class to enable it to raise the ClosingRasterSource event. This may be useful if you plan to extend the RasterSource and you need access to the event.

Details on the event:

This event is called before the closing of the RasterSource. Technically, this event is called after the calling of the Close method on the RasterSource, but before the protected CloseCore method.

It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This method allows you to raise the OpenedRasterSource event from a derived class.

You can call this method from a derived class to enable it to raise the OpenedRasterSource event. This may be useful if you plan to extend the RasterSource and you need access to the event.

Details on the event:

This event is called after the opening of the RasterSource. Technically, this event is called after the calling of the Open method on the RasterSource and after the protected OpenCore method is called.

It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This method allows you to raise the OpeningRasterSource event from a derived class.

You can call this method from a derived class to enable it to raise the OpeningRasterSource event. This may be useful if you plan to extend the RasterSource and you need access to the event.

Details on the event:

This event is called before the opening of the RasterSource. Technically, this event is called after the calling of the Open method on the RasterSource, but before the protected OpenCore method.

It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This method opens the RasterSource so that it is initialized and ready to use.

This protected virtual method is called from the concrete public method Open. The Open method plays an important role, as it is responsible for initializing the RasterSource. Most methods on the RasterSource will throw an exception if the state of the RasterSource is not opened. When the map draws each layer, it will open the RasterSource as one of its first steps; then, after it is finished drawing with that layer, it will close it. In this way, we are sure to release all resources used by the RasterSource.

When implementing this abstract method, consider opening files for file-based sources, connecting to databases in the database-based sources and so on. You will get a chance to close these in the Close method of the RasterSource.

<!– ThinkGeo.MapSuite.Core.RasterSource(overriden) –> Go Back

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This property allows the active layers requested from the client to be shown on the map.

When requesting a map, a client may specify the layers to be shown on the map.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This property allows the active styles requested from the client to be shown on the map.

When requesting a map, a client may specify the styles to be shown on the map.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This property gets and sets the amount of blue to apply to the image.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This property gets or sets the base authentication interface for retrieving credentials for Web Client authentication.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This property gets or sets the projected or geographic coordinate reference system to be used.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This property indicates the format in which the client wishes to be notified of service exceptions.

Upon receiving a request that is invalid according to the OGC standard, the server shall issue a service exception report. The service report is meant to describe to the client application or its human user the reason(s) that the request is invalid.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This property gets and sets the amount of green to apply to the image.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This property returns true if the RasterSource has projection text, false if not.

Before you call GetProjectionText method, you should check this property to ensure that your RasterSource has projection information. It will throw an exception if there is no projection information in the RasterSource.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This property gets and sets if the image should be converted to grayscale.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This property gets and sets whether the image should be converted to negative (inverse colors).

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This property returns true if the RasterSource is open and false if it is not.

Various methods on the RasterSource require that it be in an open state. If one of those methods is called when the state is not open, the method will throw an exception. To enter the open state, you must call the RasterSource's Open method. The method will raise an exception if the current RasterSource is already open.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This property gets or sets whether the response map image's background color is transparent or not.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This property gets or sets the desired output format for the map being requested from the WMS.

When requesting a map, a client may specify the output format in which to show the map. Formats are specified as MIME types such as “image/gif” or “image/png”.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This property specifies a dictionary used to update the request sent from the client to the WMS server.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This property gets or sets the proxy used for requesting a Web Response.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This property gets and sets the amount of red to apply to the image.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This property specifies the timeout of the web request in seconds. The default timeout value is 20 seconds.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This property gets and sets the amount of transparency to apply to the image.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This property specifies the URI of the WMS server.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This property returns true if the RasterSource has projection text, false if not.

This protected virtual method is called from the concrete public property HasProjectionText. The default implementation for this method returns false. So if you inherit RasterSource, please ensure that you override this virtual property to return the correct projection status of your RasterSource.

We will check the HasProjectionText status before you call the GetProjectionText method. It will throw an exception if the HasProjectionText property returns false.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This event is called after the closing of the RasterSource.

This event is called after the closing of the RasterSource. Technically, this event is called after the calling of the Close method on the RasterSource and after the protected CloseCore method.

It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This event is called before the closing of the RasterSource.

This event is called before the closing of the RasterSource. Technically, this event is called after the calling of the Close method on the RasterSource, but before the protected CloseCore method.

It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This event is called after the opening of the RasterSource.

This event is called after the opening of the RasterSource. Technically, this event is called after the calling of the Open method on the RasterSource and after the protected OpenCore method is called.

It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This event is called before the opening of the RasterSource.

This event is called before the opening of the RasterSource. Technically, this event is called after the calling of the Open method on the RasterSource, but before the protected OpenCore method.

It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.

<!– ThinkGeo.MapSuite.Core.RasterSource –> Go Back

This event is called before sending the reqeust for raster image.

This event is called before sending the reqeust for raster image. It is typical that user want to get the url of reqeust and modify it according to their requirements. For example, user could create a signiture for it, and verify it on the server side.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

This event is called after sent the request for raster image and the HttpWebResponse has come back.

<!– ThinkGeo.MapSuite.Core.WmsRasterSource –> Go Back

NOTOC MapSuiteCore ThinkGeo.MapSuite.Core UpdateDocumentation