Deploying ASP.NET applications

You need to deploy several types of files to the production server for an ASP.NET Web application:

Application files

When you build an ASP.NET application, the code class file (.aspx.vb, or .aspx.cs), but not the .aspx file, is compiled into a project DLL file along with all other class files included in your project. You need to deploy this DLL and the .aspx file to the server.

Application-specific files should be copied to the bin directory for your application in a path on the default Web share root directory (wwwroot).

Deployment libraries

The deployment library (PBD) or PBL file or files that contain the DataWindow objects used in your application must be available on the Web server. The WebDataWindowControl’s LibraryList property contains URLs of the PBLs or PBDs that the Web DataWindow uses to load the DataWindow object. You deploy the PBLs or PBDs as content resources as you would image resources.

At runtime, the URL of a PBL or PBD is mapped internally into a physical directory and file from which the DataWindow object is loaded. If the URL is not an absolute physical file path, it should be part of your Web application’s virtual path.For example, suppose your Web application’s URL is http://localhost/mydemo and it maps to C:\Inetpub\wwwroot\MyDemo, and that there is a subdirectory called pbls in C:\Inetpub\wwwroot\MyDemo. If the pbls directory contains dwobjects.pbl, the URL for this PBL should be /mydemo/pbls/dwobjects.pbl.

At runtime, the Page.MapPath method maps /mydemo/pbls/dwobjects.pbl to C:\Inetpub\wwwroot\MyDemo\pbls\dwobjects.pbl.You can also use an absolute file path URL in the LibraryList property, such as:

file:///C:\Inetpub\wwwroot\MyDemo\pbls\dwobjects.pbl

For more information about PBD files, see “About deployment libraries”.

DataWindow .NET runtime files

You must deploy a set of core DataWindow .NET runtime files with a DataWindow .NET application, as well as files that are required if your application uses specific features. For a complete list of files, see “DataWindow .NET runtime files”.

Some of these files are unmanaged DLLs. The Web application looks for these files in a directory specified in an environment variable named DWDOTNET20. If you use the packaging tool provided with DataWindow .NET, this environment variable is created for you. For more information, see “Finding files in a Web application”.

Four of the files you need to deploy, DataWindow.dll, DataWindowInterop.dll, WebDataWindow.dll, and Sybase.PowerBuilder.Db.dll are strong-named assemblies. A strong name includes the assembly’s identity as well as a public key and a digital signature. The way you deploy these files can limit your choice of deployment techniques. For more information, see “Deploying .NET assemblies”.