Export (0) Print
Expand All

OBJECT Declarations

IIS 6.0

You can create objects with session or application scope in the Global.asa file by using the extended <OBJECT> tag. This tag is self-contained and can be used outside of any <SCRIPT> tags.

The objects declared in the Global.asa file are not created until the server processes a script that calls that object. This saves resources by creating only the objects that are needed.

The server does not call the OnStartPage and OnEndPage methods for objects created with application scope. For more information about component scope, see Setting Object Scope and Determining Component Scope.

<OBJECT RUNAT=Server SCOPE=ScopeID=Identifier{ PROGID="progID"| CLASSID="ClassID"} >

. . .

</OBJECT>

Scope

Specifies the scope of the object. In the Global.asa file, Scope is set to either Session or Application.

Identifier

Specifies a name for the object instance.

ProgID

An identifier associated with a class identifier. Either ProgID or ClassID must be specified in the <OBJECT> tag. The format for ProgID is [Vendor .]Component[ .Version].

ClassID

Specifies a unique identifier for a COM class object. Either ProgID or ClassID must be specified in the <OBJECT> tag.

The objects declared in the Global.asa file can be used by any script in the application. For example, if you declared the following object:


--- Global.asa --- 
<OBJECT RUNAT=Server SCOPE=Session ID=MyAd PROGID="MSWC.AdRotator"> 
</OBJECT> 

You could reference the object MyAd from any page in the application:


--- Some.asp --- 
<%= MyAd.GetAdvertisement("/ads/adrot.txt") %>   


The first of the following examples creates an object of session scope named MyConnection by using the ProgID parameter. The second example uses the ClassID parameter.


<OBJECT RUNAT=Server SCOPE=Session ID=MyConnection PROGID="ADODB.Connection"> 
REM Object Script 
</OBJECT> 

<OBJECT RUNAT=Server SCOPE=Session ID=MyConnection CLASSID="Clsid:8AD3067A-B3FC-11CF-A560-00A0C9081C21"> 
REM Object Script 
</OBJECT> 


Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

Show:
© 2014 Microsoft