Server Object

The main function of Server object is the create an instance of object on the server.

Server.CreateObject Method

Server.CreateObject Method creates an instance of an object from a server component on the server.

Syntax:

CreateObject(
    progID
)

 Or in an ASP file. Imply

<% Server.CreateObject(progID) %>

Parameters:

progID

The paramete "progID" is used to specify the type of object to create on the server. The format for progID is [Vendor.]Component[.Version].

Return Values:

This method has no return values.

Remarks:

If the component has implementd the OnStartPage and OnEndPage methods, the OnStartPage method will be called when the component is called by the CreateObject method.

By default, objects created by the Server.CreateObject method have page scope. And therefore objects created during the processing of an ASP page will be destroyed automatically by the server after the completion of the page response. 

In order to create object with session or application scope, the object can be created by using the <OBJECT> tag in the Global.asa file and set the SCOPE attribute to SESSION or APPLICATION,. Or the oject can be stored in a session or an application variable. Similarly, the created object will be destroyed when the Session or Application object is destroyed.

A Session object will be destroyed when the session times out, or the Session.Abandon method is called. But an object can be destroyed by setting the variable of an object to Nothing or setting the variable to a new value.

But an object instance can not be created with the same name as a build-in object.

Examples:

• Creation of an instance of object from a server component, "MSWC.AdRotator" in page scope.

  ASP script command:

  <%
  Set AdRot = Server.CreateObject("MSWC.AdRotator")
  %>
  

• Creation of an instance of object from a server component, "MSWC.AdRotator" in session scope.

  ASP script command:

  <%
  Set Session("AdRot") = Server.CreateObject("MSWC.AdRotator")
  %>
  

• Destroy the instance of object with page scope.

  ASP script command:

  <%
  Set AdRot = Nothing
  %>
  

• Create an object instance with the same name as a built-in object is not allowed.

  ASP script command:

  <%
  ' Error
  Set Response = Server.CreateObject("Response")
  %>