- Displaying other files
- Encoding parameters
- Pre-launched sessions
ASPDisplay (Function) In french: ASPAffiche Calls an external ASP script and returns the result page in the current browser window. It is recommended to use this function to run ASP scripts (rather than ScriptDisplay).
// Runs the "Script1.asp" script found at the root of the Web site
// and returns the result to the Web user
ASPDisplay("/Script1.asp")
// Back to the page for ASP initialization
ASPDisplay("/localstart.asp")
// Login page in asp. Sends 3 parameters with the GET method
ASPDisplay("/ASP/Login.asp", "Name=BOB&Pass=My+Secret&Lang=3")
// Go back to the "home" page of the site
ASPDisplay("/default.htm")
Syntax
ASPDisplay(<Script name> [, <"Name1=Param1&Name2=Param2&..."> [, <Redirection>]])
<Script name>: Character string Path and name of the script. The path can be: - a full URL "http://..."
- a path relative to the root of the site "/...". In this case, the script and the Web site must be found on the same server, in one of the site sub-directories.
<"Name1=Param1&Name2=Param2&...">: Optional character string Parameters intended for the script. This string contains for each parameter:- the name of the parameter ("Name1" for example),
- the = sign,
- the value of the parameter ("Param1" for example).
Two parameters are separated by the & sign. <Redirection>: Boolean Used to define the HTTP return code of the function to the browser. This return code is mainly used for the referencing by the search engines. This parameter can correspond to: - True: permanent redirection (HTTP code 301). The page displayed by the function will be referenced directly.
- False (default value): temporary redirection (HTTP code 302). Only the source page will be referenced.
Remarks ASPDisplay can also be used on a document that is not an ASP script. In this case, the document is returned (equivalent to FileDisplay, by specifying a URL instead of a physical address). The content of parameters is automatically encoded to get a valid URL: - transformation into UTF-8 (according to the options of the page and project).
- encoding of special characters.
Pre-launched sessions If your project uses pre-launched sessions, this function must not be used in the project initialization event. This function must be used in the "Initializing the project after connection to the site" event. |
|
|
|