Common Callback

How to use

If the sample has associated data, you will find that the sample's zip file includes a "data" folder alongside the language folders. However, you will need to update the sample to point to the location of the data once you have extracted all the files.

1. Verify that the Web ADF for the .NET Framework is installed and functioning properly. For information on installing and configuring the Web ADF, consult the installation guide.
2. In Windows Explorer, navigate to <ArcGIS Developer Kit install location>\Samples\ServerNET. This folder contains the Common_Callback CSharp and VBNet folders.
3. Open the folder of the language you are going to use (that is, CSharp or VBNet), and copy the Common_Callback_<language> folder to c:\inetpub\wwwroot. The <language> variable can be CSharp or VBNet.
4. Open the IIS Manager from Control Panel, Administrative Tools, Internet Information Services (IIS) Manager, or Internet Information Services.
5. In the console tree view on the left, navigate to Local Computer, Web Sites, Default Web Site. Expand Default Web Site. Right-click the Common_Callback_<language> folder and click Properties. The Properties dialog box appears.
6. Click the Directory tab, click the Create button in the Application Settings section, then click OK to close the Properties dialog box.
7. Start Visual Studio 2010 and open the Common_Callback_<language> solution (for example, Common_Callback_CSharp2010.sln) located in c:\inetpub\wwwroot\Common_Callback_<language>\Common_Callback_<language><vs_version>. The <vs_version> references the Visual Studio version of the solution.
8. In the Solution Explorer, right-click Default.aspx, and select Set As Start Page.
9. Open the Default.aspx page in Design view, open the properties window for the MapResourceManager control, and click the ellipsis next to the ResourceItems property. The ResourceItem Collection Editor dialog box appears.
10. Add or change the MapResourceItem associated with a map service (ArcGIS for Server, ArcIMS and so on). In some of the sample code, it is assumed that the resource is in a geographic coordinate system (GCS).
11. If necessary, set the run time identity of the Web application by following one of the following two steps. If not necessary, proceed to Step 14.
12. At design time, the identity of the user running Visual Studio is used to connect to an ArcGIS for Server local data source. At run time, that identity is established by the Web application. Only one identity can be used to define access to the ArcGIS for Server local data sources in a single Web application. This identity can be explicitly defined when building the Web ADF application in Visual Studio by right-clicking the Web project in the Solution Explorer and selecting the Add ArcGIS Identity option. Add the identity credentials that will be used to access ArcGIS for Server local resources at run time. This information is added to the web.config file in a standard ASP.NET identity tag. If the Encrypt identity in web.config check box is selected, the identity tag will be encrypted; otherwise, the username and password are stored as clear text.
13. Open the web.config file, add an <identity> element in <system.web>, set the impersonate attribute to true, add a username and password attribute, and set them to a valid user account. If you are working with ArcGIS for Server local data sources, ensure the account has access to the geographic information system (GIS) server resources referenced in the Map control.
14. Save the project.
15. Click the Debug drop-down menu and click Start Debugging.

1. Browse to the viewer uniform resource locator (URL), for example, http://localhost/Common_Callback_CSharp.
2. On the toolbar above the map, click the Zoom In tool, and zoom in to an area of the map. The HTML text on the edges of the map, control the update with the extent boundaries of the map. This information was appended to the callback for the Map control upon an extent change. The Web ADF JavaScript libraries processed the custom CallbackResult objects and updated the appropriate content.
3. On the toolbar above the map, click the CenterAt Tool.
4. Click an area of the map. The map redraws centered on clicked location. The custom tool code shows that the Map control was not explicitly refreshed. If the content of the map does not change and the scale remains the same, the map does not need to call Refresh(). The custom tool also includes code to create custom CallbackResult objects to modify other content on the page. This is provided as an example of how to do this in a custom tool.
5. Below the map, add x,y coordinates in the text boxes provided.
6. Click the Zoom To Point button to zoom to the coordinates provided. This initiates a custom callback to the Web application. A string message containing the type of action and the coordinate values is sent to the Web application via the ZoomToPointClient() JavaScript function in the Default.aspx file. The ZoomToPointServer() method in the page code file (for example, Default.aspx.cs) processes the request and applies changes to the map. The map is refreshed on the client without requiring a full postback.
7. In the custom menu to the upper right of the map, select the option to zoom to a defined location, that is, California or New York. In both locations, it is assumed that the map is in a GCS. You can change the code in the page code file to modify this behavior.