0 out of 1 rated this helpful - Rate this topic

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.

Syntax

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

. . .

</OBJECT>

Parameters

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.

Remarks

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") %>

Example Code

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>

Requirements

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

Other Resources

ASP.NET Server-Side Object Tag Syntax

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)