PageToASP (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Functions specific to WEB

Page management functions

Outgoing format and page optimization

Caution: a single action can be performed at a time on the same page

See also

PageToASP (Function)

In french: PageVersASP

Sends the data found in a page currently displayed in the browser to an ASP server.

Example

// Provoque une validation de la page courante
// Et envoie le contenu de la page courante au serveur ASP
PageToASP("", "http://www.ServeurASP.com/PageTest")

Syntax

PageToASP(<Page> , <Target URL> , <Send method> [, <Destination> [, <Browser window> [, <Options> [, <Width> [, <Height> [, <Horizontal position> [, <Vertical position> [, <JavaScript parameters>]]]]]]]])

<Page>: Page name

Name of the page whose data must be sent to the ASP server. If this parameter corresponds to an empty string (""), the current page will be used. This page must be currently displayed in the browser.

<Target URL>: Character string

URL of the ASP page to which the data found in the WEBDEV page must be sent.

<Send method>: Character String constant

Method used to send the data to the ASP server:
GET The data is sent to the server via the URL.
POST The data is sent after the HTTP headers, in the body of the request.

<Destination>: Optional character string or constant

Name of target frame. <Destination> can also take the following values:
CurrentFrame the target is the current frame (default value).
ParentFrame the target is the container of the current page (parent frameset, parent browser).
CurrentBrowser the target is the current browser.
NewBrowser the target is a new browser (a new browser window is opened). The following parameters of PageToASP are used to configure this new window.

<Browser window>: : Optional character string

Name of window in the new browser if <Target> is equal to the NewBrowser constant. This parameter allows you to redisplay a page in a browser with the same name (if several browsers are open on the computer of the Web user).

<Options>: Optional Integer constant (or combination of constants)

Parameters of window in the new browser if <Target> is equal to the NewBrowser constant:
ONLocation The address bar will be displayed.
ONScrollbar The scrollbars will be displayed.
ONFull
(Default value) The window of new browser will include all the options (equivalent to the combination of all constants).
ONResizable The window of new browser will be resizable.
ONLink The link bar will be displayed.
ONMenuBar The menu bar will be displayed.
ONSatusBar The status bar will be displayed.
ONToolbar The toolbar will be displayed.
ONSimple The window of the new browser will be a simple window (no combination of constants).

<Width>: Optional integer

Width of window in the new browser (in pixels).

<Height>: Optional integer

Height of window in the new browser (in pixels).

<Horizontal position>: Optional integer

Horizontal position (in pixels) of window in the new browser (in relation to the top left corner of the screen).

<Vertical position>: Optional integer

Vertical position (in pixels) of window in the new browser (in relation to the top left corner of the screen).

<JavaScript parameters>: Optional character string

Other JavaScript parameters that must be used when opening a new browser if <Target> is equal to the NewBrowser constant.

Remarks

Additional controls

The page can contain additional controls specific to WEBDEV (WD_ACTION, WD_BUTTON_CLICK, ...). These controls are required by WEBDEV in order to operate properly. The value of these controls is also returned to the ASP server.

Outgoing format and page optimization

The values are returned by pairs in the following format: (<Control alias>, <Control value>).

We recommend that you use "Compress the names of controls (..Alias)".

Reminder: This option is available in the characteristics for advanced optimization of the HTML code:

Configuration of projects: "Project" tab of the project description
Configuration of a page: "Advanced" tab of the page description

Caution: a single action can be performed at a time on the same page

PageToASP triggers an action on the page displayed in the browser of Web user. However, INTERNET browsers allow only one action on the page per treatment.

Consequences: PageToASP cannot be used in a code triggering an action (automatically or not). This function is ignored:

In the click code of a "submit" button (or in a procedure called by the click code of this button)
In the click code of an "other" button whose action differs from "none" (or in a procedure called by the click code of this button)
If it is followed by PageSubmit or by EmailOpenMail (in the current process, in a procedure called by the current process or in another process called by Execute).

Component: WDJS.DLL