HOWTO: Build an IIS Application and References

ID: Q191039

The information in this article applies to:

Microsoft Visual Basic Professional and Enterprise Editions for Windows, version 6.0

SUMMARY

Building your first IIS application can have some minor pitfalls. This article describes a simple IIS application to get you going.

MORE INFORMATION

Steps to Build a Simple IIS Application

From the File menu, select New Project, and then select IIS application.

Give your project a name and save the project. You cannot import a HTML file without saving the project first.

From the WebClass designer window,, select the toolbar item Add HTML Template Webitem, and then select an HTML file to add to your project.

NOTE: If you choose a xxx.htm in the working directory of your project, the WebClass designer makes a copy of the xxx.htm and renames it xxx1.htm in the working directory of your project. xxx1.htm is the HTML file the WebClass designer will be making changes to, not the xxx.htm: WebClass designer does not need the xxx.htm file. But, if you choose a xxx.htm not in the working directory of your project, it will make a copy in the working directory of your project and not change the name from xxx.htm.

By default, this HTML Template Webitem will be called Template1 in the WebClass designer window.

View the Private Sub WebClass_Start(). It has code to display a default browser page. Comment out this code or delete it so the Start event looks like the following:
```
      Private Sub WebClass_Start()
         Set NextItem = Template1
      end Sub
 
```
NextItem is used to shift processing from one WebItem to another during a single request. Using the NextItem will cause the Private Sub Template1_Respond() to fire.

Here is a sample Private Sub Template1_Respond():
```
      Private Sub Template1_Respond()
          Template1.WriteTemplate
      End Sub
 
```
The Template1.WriteTemplate will send the contents of Template1 to client browser window. Remember that Template1 is the HTML file you imported into the IIS application. If you don't put anything in this event and you run the project, the browser will come up with a blank page. You should do a dry run of this process to see how it works.

Hit the F5 key to run the project. The WebClass designer will prompt you with a default Virtual directory that it is going to create in which to run the WebClass.

The page you created should have come up in the browser. Now change some code to experiment:


   Private Sub Template1_Respond()
   'Write a reply to the user
     With Response
        .Write "<html>"
        .Write "<body>"
        .Write "<h1>WebClass1's Starting Page</h1>"
        .Write "<p>Response was created in the Template1_Respond event</p>"
        .Write "</body>"
        .Write "</html>"
    End With
   End Sub

Press the F5 key to run the project.

Go to your projects Properties. On the General tab, set these project options for optimal performance: Retain In Memory, Unattended Execution and Apartment Threaded.

REFERENCES

A WebClass sample will be located at the following location when you install the MSDN samples:

Microsoft Visual Studio\MSDN98\98VS\1033\Samples\VB98\WcDemo\WCDEMO.VBP

For additional information, please see the following article in the Microsoft Knowledge Base:

Q190252 : HOWTO: Change Default HTML Editor

Please see the following Microsoft Knowledge Base articles for more information on WebClasses:

Q189538 : BUG: Need to Remove the "Me" References from WcDemo Sample

Q191036 : INFO:Option Explicit Statement Is Not Added by WebClass Designer

Q189539 : INFO: VB 6.0 Readme Part 8: WebClass Designer Issues

Q191038 : INFO: WebClass Initialize, BeginRequest, Terminate Events

Q189540 : PRB: Access Denied Error on WebClass Files

Q190253 : VB6 Designers Do Not Work in VB5

Q191125 : Error Logging Could Have Problems in WebClass Designers

Q191119 : VB Classes Can Cause IIS to have Access Violations

Q191035 : Changes to WebClass Templates Not Always Detected

At the following location on the MSDN there is more detailed information about Developing IIS applications:

Visual Basic Documentation\Using Visual Basic\Component Tools Guide\ Building Internet Applications\Developing IIS Applications


Keywords          : kbsample kbInternet kbVBp kbVBp600 kbWebClasses 
Version           : 
Platform          : WINDOWS 
Issue type        : kbhowto

Last Reviewed: May 7, 1999