Server Object

Another function of Server object is the execution of file on the server.

Server.Execute Method

Server.Execute Method execute an ASP file similar to a procedure call on the server.

Syntax:

Execute(
    Path
)

 Or in an ASP file. Imply

<% Server.Execute(Path) %>

Parameters:

Path

The paramete "Path" is used to specify the location of the ASP file to execute. The parameter Path may be either an absolute or a relative path. For an absolute Path, the path must map to an ASP script in the same application as the calling ASP file. Path can be a string variable name that is set at run-time. But the parameter Path must not contain a query string, or IIS returns an error.

Return Values:

This method has no return values.

Remarks:

The Server.Execute method calls an ASP file similar to a procedure call, and processes it as part of the calling ASP script.

The Server.Execute method allows the dividing of a complex application into indivuidual modules. These ASP files forms a library that can be called whenever necessary. The Server.Execute method provides the method to call an ASP file dynamically and can be considered as an alternative approach to server-side include directives.

The Server.Execute method returns the ASP 0173 error, "Invalid Path Character", if the parameter Path contains any of the following characters:

• Asterisk (*)

• Question mark (?)

• Angle brackets (< or >)

• Comma (,)

• Colon or semi-colon (: or :)

• Single-quote or double-quote (' or ")

• Right square bracket (])

• Double slashes (// or \\)

After IIS processes the ASP file specified in the input parameter to Server.Execute, the response is returned to the calling ASP script.

The following collections and properties are available to the executed ASP page:

• Application variables, even if they are set in the calling page.

• Session properties, even if they are set in the calling page

• Server variables and properties, even if they are set in the calling page. This includes Form and QueryString data passed to the calling page.

• Response collections and properties. The executed ASP file may modify HTTP headers. However, as with any ASP file, if the executed ASP file attemps to modify HTTP headers after it sends a response to the client, it generates an error.

If a file is included in the calling page by using #include, the executed ASP will not use it.

If either the calling or called ASP file conttains a transaction directive, the status of the transaction will apply to the ASP file that contains the directive.

Examples:

• Implement Server.Execute method as a dynamical call of an ASP file  .

  ASP script command:

  <%
  langchoice = Request.ServerVariables("HTTP_ACCEPT_LANGUAGE")
  Server.Execute(langchoice & "default.asp")
  %>
  

• Server.Execute will not process the "#include" line in the called page.

  ASP script command:

  -----calling page-----
  <%
  Function Test
  End Function
  Server.Execute("called .asp")
  %>

  -----called page-----
  <%
  ' Function Not Available
  Call Test
  %>
  

• Transaction status will apply to the ASP file that contains the transaction directive.

  ASP script command:

  -----calling page-----
  <@ Transaction=Required %>
  <%
  Server.Execute("called .asp")
  Sub OnTransactionAbort
  Sub OnTransactionCommit
  %>

  -----called page-----
  <@ Transaction=Required %>
  <%
  ' Function Not Available
  Sub OnTransactionAbort
  Sub OnTransactionCommit
  %>

  -----Transaction Abort while called page is being processed-----
  The OnTransactionAbort subroutine of called page will be called if present.
  After the completion of the called page and return to calling page.
  The OnTransactionAbort subroutine of calling page will be called if present.