User Guide

146 Chapter 8: Using Flash Remoting for Microsoft .NET
As the figure shows, the local assembly cache in the myASPApp directory contains the Flash
Remoting assembly, flashgateway.dll. Also, to connect a Flash application with a remote service,
you must reference a physical resource in your application’s directory in the web root. Flash
Remoting automatically installs a blank ASPX page named gateway.aspx, but you can use any
ASPX file in the application directory.
The web.config file contains the registration for the flashgateway.dll. The HttpModule reference
handles all web requests to ASP.NET resources. Here is an example:
<httpModules>
<add name="GatewayController"
type="FlashGateway.Controller.GatewayController,flashgateway" />
</httpModules>
If the request contains AMF, Flash Remoting proceeds with the request.
Note: The Flash Remoting for .NET installer creates a directory in your web root named
flashremoting. Inside the flashremoting directory, you will find a local assembly cache (bin directory)
and a Samples directory, which contains example Flash applications.
Setting up a Flash Remoting ASP.NET application
Before you can start development with Flash Remoting, you must set up your ASP.NET
application. The Flash Remoting for .NET installer creates a preconfigured application for you
named flashremoting. You can find the flashremoting folder in your IIS webroot, such as C:/
Inetpub/wwwroot/flashremoting.
When creating the directory structure for your own ASP.NET application that uses Flash
Remoting, you must assign specific security permissions to the local assembly cache. Using
Microsoft Windows XP as the operating system, the following procedure creates an ASP.NET
application directory for Flash Remoting.
To create an ASP.NET application directory for Flash Remoting:
1. In your web root, create a new folder named myASPApp.
2. In the myASPApp folder, create a new folder named bin. The bin folder serves as the local
assembly cache.
3. Copy the Flash Remoting assembly, flashgateway.dll, from the installation directory to the bin
folder in the myASPApp directory.
4. Right-click the bin folder. In the submenu that appears, select Properties. In the Properties
dialog box, select the Security tab. In the Security panel, add the ASPNET user and give that
user write access. Click OK.
5. In the myASPApp folder, create a blank ASPX page. The gateway URL points to this page.
6. Copy the web.config file from the flashremoting directory to the myASPApp directory. For
Flash Remoting, the most important part of the web.config file is the
httpModule tag that
registers the Flash Remoting assembly, as the following example shows:
<httpModules>
<add name="GatewayController"
type="FlashGateway.Controller.GatewayController,flashgateway" />
</httpModules>