| Platform SDK: IIS SDK |
The CreateObject method creates an instance of a server component. If the component has implemented the OnStartPage and OnEndPage methods, the OnStartPage method is called at this time.
Server.CreateObject( progID)
By default, objects created by the Server.CreateObject method have page scope. This means that they are automatically destroyed by the server when it finishes processing the current ASP page.
To create an object that has session or application scope, you can either use the <OBJECT> tag in the Global.asa file and set the SCOPE attribute to SESSION or APPLICATION, or you can store the object in a session or application variable.
For example, an object stored in a session variable, as shown in the following script, is destroyed when the Session Object object is destroyed. That is, when the session times out, or the Session.Abandon method is called.
<% Set Session("ad") =index.html Server.CreateObject("MSWC.AdRotator")%>
You can also destroy the object by setting the variable to
Nothing or by setting the variable to a new value, as
shown in the following code. The first example releases the object
ad. The second replaces ad with a string.
<% Session("ad") =index.html Nothing %>
<% Session("ad") = "some other value" %>
You cannot create an object instance with the same name as a built-in object. For example, the following returns an error.
<% Set Response =index.html Server.CreateObject("Response") %>
The following example creates a server component, MyAd, as a MSWC.AdRotator component that can be used to automate the rotation of advertisements on a Web page.
<% Set MyAd =index.html Server.CreateObject("MSWC.AdRotator") %>
For more information about server components, see Building COM Components for ASP.
Platforms: Windows 2000 with IIS 5.0 installed,
Windows XP with IIS 5.1 installed,
Windows Server 2003 family with IIS 6.0 installed
 |
What did you think of this topic? |
 |
Order a Platform SDK CD |