Getting Started with CaliperForm
The example located in the folder GISDK\Samples\DotNet under the Maptitude program folder demonstrates how to access the GISDK environment from a console application. The Maptitude .NET classes are stored in CaliperForm.dll. The file is stored in the Code Samples folder as C:\Users\[Username]\Documents\Caliper\Maptitude YYYY\CodeSamples, where YYYY is the year of your Maptitude version and [Username] corresponds to the name assigned to the current user’s account
Here is an example of how to use CaliperForm.dll in a C# console project.
-
Use Visual Studio to create a C# console project.
-
Add a reference to CaliperForm.dll by choosing References>Browse and browse for the DLL in Documents\Caliper\Maptitude YYYY\CodeSamples\CaliperForm.dll.
-
Replace the contents of the automatically generated Program.cs file, by copying the contents of Program.cs in the GISDK\API\Dotnet folder.
You now have a sample .NET console program that you can compile and test.
The example illustrates in a nutshell how to access GISDK data from a .NET application. The example opens a connection to the GISDK environment, opens a map, and closes the connection to the GISDK environment:
C# Example
using System;
using System.Collections.Generic;
using System.Text;
using CaliperForm;
///
/// Open a map in the tutorial folder, and list its content.
///
static void Open_Map() {
CaliperForm.Connection Conn = new CaliperForm.Connection
{ MappingServer = "Maptitude" };
Boolean opened = false;
try {
opened = Conn.Open();
if (opened) {
// You must declare dk as "dynamic" or the compiler will throw an error
dynamic dk = Conn.Gisdk;
string tutorial_folder = dk.Macro("G30 Tutorial Folder") as string;
// Obtain information about Conn: an array of [ "program_path" , "program
// name" , "program type" , build number (integer) , version number (real) ,
// instance number ]
Object[] program_info = dk.GetProgram();
string program_name = program_info[1] as string;
int build_number = (int)program_info[3];
double version_number = (double)program_info[4];
// Set the path that will be used to look for layers used in map files
string search_path = "c:\\ccdata\\USA (HERE) - 2023 Quarter 4;d:\\ccdata";
dk.SetSearchPath(search_path);
// Open a map file in the tutorial folder
string map_file = tutorial_folder + "BestRout.map";
var map_options = new OptionsArray();
// you can also use Dictionary or Hashtable
map_options["Auto Project"] = "true";
string data_directory = System.IO.Path.GetDirectoryName(map_file);
map_options["Force Directory"] = data_directory;
// path used to look for layers used in the map
string map_name = dk.OpenMap(map_file, map_options) as string;
if (map_name == null) {
Console.Out.WriteLine("Cannot open map " + map_file +
". Perhaps some layers cannot be found?");
return;
} else {
Console.Out.WriteLine("map_name = " + map_name);
}
// Set the current layer
dk.SetLayer("County");
// Get information about the list of layers contained in this map
dynamic layers = dk.GetMapLayers(map_name, "All");
dynamic layer_names = layers[0];
int current_idx = (int)layers[1];
string current_layer = layers[2] as string;
dk.CloseMap(map_name);
Conn.Close();
}
} catch (System.Exception error) {
Console.Out.WriteLine(error.Message);
}
}For more information, see:
Getting Started with CaliperForm
Using the CaliperForm.Connection Class
Using the GISDK Extension Engine In-Process API
See also these specific C# examples for: